Instalarea modulului

Metoda de instalare recomandata este prin composer.
Comenzi:
composer require btrl/ipay sau btrl/ipay-card-on-file
bin/magento module:enable BTRL_Ipay  / BTRL_IpayCardOnFile
bin/magento setup:upgrade

Configurarea modulului

Pentru configurarea modulului, accesați meniului Stores --> Configuration --> Sales -- > Payment Methods.

Localizați pluginul BT iPay Payment în listă și apoi faceți click pe acesta.

• Active – Se alege opțiunea:
  • Yes – pentru a activa metoda de plată în pagina de checkout
  • No – pentru a inactiva metoda de plată în pagina de checkout
• Enable Card On File – Se alege opțiunea “Yes/No” pentru a permite/interzice clientului să salveze carduri și să le folosească pentru plăți ulteriore. Această funcționalitate este disponibilă doar pentru comerciantii cu drepturi corespunzatoare în conformitate cu contractul de acceptare plăți.
• Title - Informațiile completate în acest câmp controlează titlul metodei de plata care va fi afișat în pagina de checkout. Implicit se va afișa mesajul “Plata online prin BT iPay”
• Description On Bank Receipt – Informațiile completate în acest câmp reprezintă „Descrierea comenzii”.
• Test mode? – Se alege opțiunea “Yes/No”  pentru a activa / dezactiva modul de test. Pentru funcționarea tranzacțiilor online prin BT iPAY, este necesar să introduceți credențialele API furnizate de Banca Transilvania. Atenție! Credențialele de producție nu funcționează pe mediul de test sau vice-versa.
• În cazul în care modul “Test mode” este setat pe “Yes”, este necesar să introduceți credențialele API de test:
  • Username – user-ul de API pentru mediul de test
  • Password – parola de API pentru mediul de test
• În cazul în care modul “Test mode” este setat pe “No”, este necesar să introduceți credențialele API de producție:
  • Username – user-ul de API pentru mediul de producție
  • Password – parola de API pentru mediul de producție
• Payment through – Se alege tipul de plată în funcție de serviciile prestate:
  • One Phase – Pentru tranzacții 1-phase. Tranzacția se decontează automat fără a fi nevoie de finalizarea ei de către un operator, după verificarea stocului. Opțiunea este folosită îndeosebi pentru servicii gen asigurări/bilete/abonamente.
  • Two phase – Pentru tranzacții 2-phase. Tranzacția necesită intervenție pentru trimiterea în decontare. Opțiunea este folosită îndeosebi serviciilor de bunuri care necesită livrare.
• Send Auto-Invoice Email - Pentru plăți one phase, se alege opțiunea “Yes”  pentru a trimite mail catre clientul plătitor pentru tranzacție finalizată.
• New order status – Status default pentru o comandă nouă (Pending).
• Paid order status – Status default pentru o comandă finalizată (Processing).
• Cancel pending orders older than [hours] – Timp specificat în ore pentru actualizarea tranzactiilor abandonate de clienți în status Cancel.
• SCA Exemption – Pentru funcționalitatea Card On File excepțiile se agrează punctual între BT și comerciant, iar folosirea excepțiilor neagreate va rezulta în tranzacții non-compliant PSD2 care vor trece prin fluxul 3Dsecure. Pentru comercianții fără drepturi corespunzatoare, se setează opțiunea “None”.
• Callback
  • Decryption Key (Base64) – Cheie de securitate necesară pentru a verifica răspunsul pentru callback. Această cheie va fi furnizată de către echipa Aplicatii Ecommerce, ca răspuns la cererea de funcționalitate callback.
• Debug Logging
  • Enable – Se alege opțiunea “Yes/No”  pentru a activa / dezactiva logurile detaliate a comunicării de plată. Logurile se regăsesc la: /var/log/BTRL_Ipay/debug.log . În momentul în care solicitați asistentă, asigurați-vă că includeți acest fișier.
• După completarea câmpurilor, accesați butonul “Save config”.

Gestionarea plăților 

Pentru fiecare comandă plătită folosind BT iPay, administratorul site-ului poate efectua următoarele acțiuni din detaliile comenzii:

1. Capture: Pentru încasarea tranzacțiilor realizate prin 2-phase (Authorized) este necesar să accesați butonul “Invoice” din detaliile tranzacției, selectarea optiunii “Capture Online”, urmat de accesarea butonului “Submit Invoice”. Operațiunea de încasare (deposit) se realizează integral.
2. Cancel: Pentru anularea/reversarea unei plăți realizate prin 2-Phase (Authorized), este necesar să accesați butonul “Void” din detaliile tranzacției.
3. Refund: Pentru rambursarea parțială sau totală a unei plăți capturate/deposited, este necesar să accesați butonul “Invoices” din detaliile tranzacției, acțiunea “View” 🡪 “Credit Memo”, selectarea produselor și cantitatea acestora (după modificare accesați butonul Update Qty's), urmat de accesarea butonului “Refund”.

Dezinstalare modul

Comenzi prin composer:
bin/magento disable:unistall BTRL_Ipay  / BTRL_IpayCardOnFile
bin/magento module:unistall BTRL_Ipay  / BTRL_IpayCardOnFile

Link GitHub:

Modul iPAY:  https://github.com/Banca-Transilvania/magento2-ipay 

Extensie COF: https://github.com/Banca-Transilvania/magento2-ipay-card-on-file

Link descărcare modul BT iPay:

https://packagist.org/packages/btrl/ipay

https://packagist.org/packages/btrl/ipay-card-on-file