Alegerea tipului de plăți în funcție de serviciile prestate:

• 1-phase se pretează serviciilor gen asigurări, bilete/abonamente, unde “deposit” se realizează în mod automat pentru tranzacțiile finalizate cu succes. 
• 2-phase se pretează serviciilor de bunuri care necesită livrare, unde întâi se blochează suma, iar la livrarea/confirmarea livrării bunurilor este necesar să realizați “completarea” tranzacției și trebuie generat “deposit”.

Credențialele de acces sunt perechi de tipul nume de utilizator și parolă și sunt furnizate de către Banca Transilvania în momentul creării comerciantului pe platforma iPay. Acestea sunt necesare pentru accesarea consolei iPay și pentru apelarea API-urilor.
Atentie! Credențialele de producție nu funcționează pe mediul de test sau vice-versa.


Trimitere link de plată către client
Afacerea ta are la bază negocierea contravalorii produsului oferit spre vânzare, însă nu ai găsit o modalitate de plată online pentru asta ? Acum ai posibilitatea să realizezi acest lucru prin iPay BT. Contactează-ne și te vom ajuta.

Instalarea modulului

• Descărcați fișierul .zip cu codul pluginului pe computer.
• Cerințe:
  • PHP 7.4 sau mai nou
  • WooCommerce 7.0 sau mai nou
• Conectați-vă cu contul de admin pe wordpress
• Click pe “Module”
• Click pe “Adaugă modul nou”
• În stânga sus, click pe butonul “Încarcă modulul”
• Click pe “Choose File”
• Selectați zip-ul pluginului din folderul unde este salvat
• Click pe butonul “Instalează acum”
• Click pe butonul “Activează modulul”
• În meniul din stânga vă poziționați pe “WooCommerce”, apoi click pe “Setări”
• În bara de sus, click pe butonul “Plăți”
• În dreptul BT iPay, click pe butonul “Administrează” .

Configurarea modulului

• Enable – Accesati butonul “Enable BT iPay” pentru a activa / dezactiva metoda de plată în pagina de checkout
• Title – Informațiile completate în acest câmp controlează titlul metodei de plata care va fi afișat în pagina de checkout. De exemplu: Online cu card bancar prin BT iPay
• Description – Informațiile completate în acest câmp controlează descrierea medotei de plată care va fi afișată în pagina de checkout sub titlu. De exemplu: Vei fi redirectionat catre platforma securizata de plata online a Bancii Transilvania. Ai siguranta maxima – BT iPay foloseste tehnologia 3D Secure, promovata de Organizatiile Internationale de Carduri Visa si MasterCard pentru a minimiza riscul de fraude din comertul pe Internet.
• Payment Description – Informațiile completate în acest câmp reprezintă „Descrierea comenzii” și va fi completat automat când este plasată o comandă. Utilizează următoarele variabile:
  •  $order_number : Acesta va fi înlocuit cu numărul unic al comenzii
  • $shop_name : Acesta va fi înlocuit cu adresa URL a magazinului unde a fost plasată comanda
  • Aceste variabile vor fi înlocuite dinamic cu valorile reale atunci când comanda este procesată. În cazul în care trebuie să adăugați un text suplimentar după aceste variabile, asigurați-vă că faceți acest lucru cu atenție pentru a menține formatarea corectă.
• Callback url – Adresa URL necesară pentru a utiliza funcționalitatea de callback pentru sincronizare plăți între BT și instanța woocommerce. În cazul în care doriți această funcționalitate, copiați această adresă URL și trimiteți-o către echipa Aplicatii Ecommerce.
• Callback key – Cheia pentru callback, 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.
• Payment Flow – Se alege tipul de plată în funcție de serviciile prestate:
  • Pay – 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.
  • Authorize – 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.
• Enable card on file – Accesați “Enable Card on File” 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.
• Test mode – Activați / Dezactivați 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 activ, este necesar să introduceți credențialele de API de test:
  • Test Username – user-ul de API pentru mediul de test
  • Test Password – parola de API pentru mediul de test
• În cazul în care modul “Test mode” este dezactivat, este necesar să introduceți credențialele de API de producție:
  • Username – user-ul de API pentru mediul de producție
  • Password – parola de API pentru mediul de producție
• Log payload data into woocommerce – Activați / dezactivați opțiunea “Log payload data into woocommerce” pentru logurile detaliate de debugging
• După completarea câmpurilor, accesați butonul “Save changes”

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 (Authorize) este necesar să accesați butonul “Capture” din tabul BT Ipay. Operațiunea de încasare (deposit) se poate realiza integral sau parțial, prin introducerea sumei în câmpul “Capture amount”.
2. Cancel: Pentru anularea/reversarea unei plăți realizate prin 2-Phase (Authorize), este necesar să accesați butonul “Cancel” din tabul BT Ipay.
3. Refund: Pentru rambursarea parțială sau totală a unei plăți capturate/deposited, puteți folosi funcționalitatea implicită de refund woocommerce, prin introducerea unei sume/produs și accesarea butonului “Refund (sumă) via BT iPay”.

Card On File

Această funcționalitate este disponibilă doar pentru comerciantii cu drepturi corespunzatoare în conformitate cu contractul de acceptare plăți.
Funcționalitatea de card on file se poate activa din pagina de configurare a modulului BT iPAY. După activarea acestei funcționalități, în pagina de checkout se va afișa un nou checkbox sub descrierea medotei de plată care va permite clientului să aleagă opțiunea de a salva sau nu a informațiilor de card, pentru plăți ulterioare.
După o plată reușită cu această opțiune activată (de salvare a informațiilor de card), la efectuarea unei comenzi ulterioare, în pagina de checkout se va afișa clientului o casetă de selecție din lista proprie de carduri salvate, sau opțiunea de a efectua plata cu un nou card prin selectarea checkbox-ului “I want to pay with a new card”. Acest nou card poate fi de asemenea salvat, dacă se dorește, prin selectarea checkbox-ului “Save my card for future uses”.
Clientul poate să își gestioneze cardurile salvate din meniul contului de client, prin accesarea “My account à Bt Ipay Saved Cards”. Clientul are posibilitatea de a adăuga, șterge, activa sau dezactiva un card.

Dezinstalarea modulului

Pentru dezinstalarea pluginului BT iPAY, acesați meniul Plugins din zona de administrare wordpress, localizați pluginul în listă și apoi faceți click pe linkul de dezinstalare.

Pentru a elimina complet datele pluginului, ștergeți următoarele tabele de baze de date:

• (wc_)bt_ipay_payments
• (wc_)bt_ipay_cards

În cazul în care vindeți exclusiv produse digitale, vă recomandam instalarea modulului special pentru produse digitale. Pentru descărcare, accesați link-ul de GitHub menționat mai jos.

Link GitHub: https://github.com/Banca-Transilvania/woocommerce.git     

Link descărcare modul BT iPay:  https://wordpress.org/plugins/bt-ipay-payments/

Instalarea modulului

•   Descărcați fișierul .zip cu codul pluginului pe computer
• Cerințe: 
  • PHP 7.4 sau mai nou
  • Prestashop 1.7.6 sau mai nou
• Conectați-vă cu contul de admin pe PrestaShop
• Accesați pagina Improve -> Modules -> Module Manager
• În dreapta sus, click pe butonul “Upload a module”
• Click pe “Select File”
• Selectați zip-ul pluginului din folderul unde este salvat. Zip-ul pluginului ar trebui să conțină folderul modul numit „btipay”
• După instalarea modulului, accesați butonul “Configure” sau Improve -> Modules -> Module Manager -> Payment -> “BT iPay” -> click pe butonul “Configure”

Configurarea modulului

Pagina de configurare a modulului BT iPay este separată în 3 secțiuni:

1. General information - detalii despre modul și modul de creare a unui cont BT
2. General settings - activare, titlu, credentiale, callback
3. Payment method settings - tipul tranzactiei, status, restrictie

I.       Configurare General Settings

• Enable – Accesati butonul “Enable” pentru a activa / dezactiva metoda de plată în pagina de checkout
• Title – Informațiile completate în acest câmp controlează titlul metodei de plata care va fi afișat în pagina de checkout. De exemplu: Online cu card bancar prin BT iPay
• Description – Informațiile completate în acest câmp reprezintă „Descrierea comenzii” și va fi completat automat când este plasată o comandă. Utilizează următoarele variabile:
  • $orderId : Acesta va fi înlocuit cu ID-ul unic al comenzii.
  • $shopUrl : Acesta va fi înlocuit cu adresa URL a magazinului unde a fost plasată comanda.
  • Aceste variabile vor fi înlocuite dinamic cu valorile reale atunci când comanda este procesată. În cazul în care trebuie să adăugați un text suplimentar după aceste variabile, asigurați-vă că faceți acest lucru cu atenție pentru a menține formatarea corectă.
• Test mode – Activați / Dezactivați 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 activ, este necesar să introduceți credențialele de API de test:
  • User name (test) – user-ul de API pentru mediul de test.
  • Password (test) – parola de API pentru mediul de test. Metoda de plată nu va apărea dacă parola nu este completată.
• În cazul în care modul “Test mode” este dezactivat, este necesar să introduceți credențialele de API de producție:
  • User name (live) – user-ul de API pentru mediul de producție
  • Password (live) – parola de API pentru mediul de producție. Metoda de plată nu va apărea dacă parola nu este completată.
•  Callback url – Adresa URL necesară pentru a utiliza funcționalitatea de callback pentru sincronizare plăți între BT și instanța PrestaShop. În cazul în care doriți această funcționalitate, copiați această adresă URL și trimiteți-o către echipa Aplicatii Ecommerce.
• Callback key – Cheia pentru callback, 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.
• După completarea câmpurilor, accesați butonul “Save General Settings”

II.     Configurare Payment method settings

• Payment Flow – Se alege tipul de plată în funcție de serviciile prestate:
  • 1-Phase – Immediate Settlement – Pentru tranzacții 1-phase. Tranzacția se decontează automat fără a fi nevoie de finalizarea ei de către un operator. Opțiunea este folosită îndeosebi pentru servicii gen asigurări/bilete/abonamente.
  • 2-Phase – Post-Delivery Settlement – 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.
• New Order Status – Status default pentru o comandă nouă.
• Approved Order Status – Status default pentru tranzacție APPROVED (2 Phase).
• Partial Capture Status – Status default pentru încasare parțială (2 Phase). Setarea default și recomandată este “Partial Capture BT iPay”. Notă: Setarea unei stări diferite va face ca modulul să se comporte neașteptat.
• Available for All Countries – Limitare în funcție de țară. Metoda de plată nu va apărea dacă nu ați selectat țara din care utilizatorul plasează comanda.
• Available for Specific Countries – Selectați țările în care această metodă de plată va fi disponibilă. Metoda de plată nu va apărea dacă nu ați selectat valutele folosite de utilizator pentru a plasa comanda.
• Allow For Currencies – Limitare în funcție de valută. Selectați anumite valute permise pentru această metodă de plată.
• Enable Card On File – Accesați “Enable Card on File” 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.
• Enable Logging – Activați logurile detaliate a comunicării de plată. Logurile se regăsesc la: var/logs/btipay/btipay-yyyy-mm-dd.log. În momentul în care solicitați asistentă, asigurați-vă că includeți acest fișier.
• Custom Refund Button – Activați pentru a apărea butonul “Refund BT iPay” în vizualizarea comenzii.
• Auto Refund – Activați “Auto Refund” atunci când creați un Credit Slip utilizând butoanele “Standard Refund” sau “Partial Refund” din Prestashop pentru a fi procesat prin BT. Defaulf: dezactivat. Dacă opțiunea este dezactivată și efectuați o rambursare totală sau parțială folosind butonul standard din Prestashop, statusul tranzacției nu va fi actualizat, iar solicitarea către BT nu va fi trimisă.
  • Realizare refund prin butonul Refund BT iPay – puteți alege să realizați rambursarea totală sau parțială prin BT iPAY utilizând butonul menționat. Notă: Dacă “Auto Refund” nu este activat, cererea nu va fi trimisă chiar dacă caseta de selectare este bifată.
• Refund on Status Change – Procesează automat rambursările atunci când statusul comenzii se schimbă în status Refunded.
• Create Order Slip on Full Refund – Creați automat un bon de comandă atunci când este emisă o rambursare totală din admin, folosind butonul “Refund BT iPay”.
• După completarea câmpurilor, accesați butonul “Save Payment Settings”

 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 BT iPay: Pentru încasarea tranzacțiilor realizate prin 2-phase (2-Phase – Post-Delivery Settlement) este necesar să accesați butonul “Capture BT iPay”. Operațiunea de încasare (deposit) se poate realiza integral sau parțial, prin introducerea sumei în câmpul “Amount” si accesarea butonului “Submit”.
2. Cancel BT iPay: Pentru anularea/reversarea unei plăți realizate prin 2-Phase (2-Phase – Post-Delivery Settlement), este necesar să accesați butonul “Cancel BT iPay”, urmat de accesarea butonului “Confirm” din fereastra nou deschisă.
3. Refund BT iPay: Pentru rambursarea parțială sau totală a unei plăți capturate/deposited, puteți utiliza funcționalitatea prestabilită de rambursare PrestaShop Partial refund / Standard refund sau implementarea personalizată “Refund BT iPay”. 

Detalii de rambursare

Pentru vizualizarea stărilor de rambursare, vizualizați secțiunea dedicată în pagina de detalii comandă, eticheta “BT iPay Refunds”. În această secțiune, puteți vizualiza în mod convenabil atât punctele de fidelitate, cât și suma totală rambursată. 

Detalii de plată

Detaliile de plată sunt actualizate în funcție de suma depozitată în BT. Pentru vizualizarea detaliilor de plată, vizualizați secțiunea dedicată în pagina de detalii comandă, eticheta “Payment (1)”. Pentru tranzacțiile doar pre-autorizate și neîncasate, suma înregistrata din plata este de 0,00 lei.

Card On File

Această funcționalitate este disponibilă doar pentru comerciantii cu drepturi corespunzatoare în conformitate cu contractul de acceptare plăți.
Funcționalitatea de card on file se poate activa din pagina de configurare a modulului BT iPAY. După activarea acestei funcționalități, în pagina de checkout se va afișa un nou checkbox sub descrierea medotei de plată care va permite clientului să aleagă opțiunea de a salva sau nu a informațiilor de card, pentru plăți ulterioare.
După o plată reușită cu această opțiune activată (de salvare a informațiilor de card), la efectuarea unei comenzi ulterioare, în pagina de checkout se va afișa clientului o casetă de selecție din lista proprie de carduri salvate, sau opțiunea de a efectua plata cu un nou card prin selectarea checkbox-ului “I want to pay with a new card”. Acest nou card poate fi de asemenea salvat, dacă se dorește, prin selectarea checkbox-ului “Save my card for future uses”.
Clientul poate să își gestioneze cardurile salvate din meniul contului de client, prin accesarea “Your account à BT IPAY - CARDS”. Clientul are posibilitatea de a adăuga, șterge, activa sau dezactiva un card.

Dezinstalarea modulului

Pentru dezinstalarea pluginului BT iPAY,accesați meniul Module Manager -> Payment din zona de administrare PrestaShop, localizați pluginul în listă și apoi faceți click pe uninstall.

Link GitHub: https://github.com/Banca-Transilvania/prestashop.git

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

Instalarea modulului

• Descărcați fișierul .zip cu codul pluginului pe computer
• Cerințe:
• PHP 7.4 sau mai nou
• OpenCart v4
• Conectați-vă cu contul de admin pe OpenCart
• În meniul Navigation, accesați meniul Extensions -> Installer
• Faceți click pe butonul de încărcare - “Upload” (cel de culoare albastră din partea dreaptă)
• Selectați zip-ul pluginului din folderul unde este salvat (ipay_opencart.ocmod.zip)
• Așteptați ca încărcarea să se finalizeze și fișierul să apară în zona “Installed Extensions”
• Instalați extensia prin accesarea meniului Extensions -> Extensions, iar în filtrul din “Choose the extension type” se selectează “Payments”, urmat de accesarea butonului verde din dreapta extensiei “BT iPay”

 Configurarea modulului

 I.       Configurare General settings

Pentru configurarea modulului, accesați meniului Extensions -> Extensions, iar în filtrul din “Choose the extension type” se selectează “Payments”. Localizați pluginul BT iPay în listă și apoi faceți click pe butonul edit.

• Enable / Disable BT iPay – Selectați opțiunea dorită pentru a activa / dezactiva metoda de plată în pagina de checkout
• Payment order – Ordinea metodei în lista de metode de plată din pagina de checkout
• Payment title – Informațiile completate în acest câmp controlează titlul metodei de plata care va fi afișat în pagina de checkout. De exemplu: Online cu card bancar prin BT iPay
• Payment description – Informațiile completate în acest câmp reprezintă „Descrierea comenzii” și va fi completat automat când este plasată o comandă. Utilizează următoarele variabile:
  •  $order_number : Acesta va fi înlocuit cu numărul unic al comenzii
  •  $shop_name : Acesta va fi înlocuit cu adresa URL a magazinului unde a fost plasată comanda
  • Aceste variabile vor fi înlocuite dinamic cu valorile reale atunci când comanda este procesată. În cazul în care trebuie să adăugați un text suplimentar după aceste variabile, asigurați-vă că faceți acest lucru cu atenție pentru a menține formatarea corectă.
• Callback url – Adresa URL necesară pentru a utiliza funcționalitatea de callback pentru sincronizare plăți între BT și instanța OpenCart. În cazul în care doriți această funcționalitate, copiați această adresă URL și trimiteți-o către echipa Aplicatii Ecommerce.
• Callback key – Cheia pentru callback, 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
• Payment Flow – Se alege tipul de plată în funcție de serviciile prestate
  • Pay – 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.
  • Authorize – 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.
•  Card On File – Accesați “Card on File” 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.
• Enable test mode – Activați / Dezactivați 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 “Enable test mode” este activ, este necesar să introduceți credențialele de API de test:
  • Test username – user-ul de API pentru mediul de test
  • Test password – parola de API pentru mediul de test.
• În cazul în care modul “Enable test mode” este dezactivat, este necesar să introduceți credențialele de API de producție:
  • Username – user-ul de API pentru mediul de producție
  • Password – parola de API pentru mediul de producție.
• După completarea câmpurilor, reveniți sus în pagină și accesați butonul “Save”

 II.     Configurare Order statuses

• Order status for payment created – statusul dorit pentru plățile noi. Exemplu: Pending
• Order status for paid payment –  statusul dorit pentru plățile finalizate cu succes. Exemplu: Processed
• Order status for authorized payment – statusul dorit pentru plățile preautorizate (pentru tranzacții 2-phase). Exemplu: Processing
• Order status for canceled payment – statusul dorit pentru plățile anulate/reversate. Exemplu: Canceled
• Order status for failed payment – statusul dorit pentru plățile declinate. Exemplu: Failed
• Order status for refunded payment – statusul dorit pentru plățile cu refund total. Exemplu: Refunded
• Order status for partially refunded payment – statusul dorit pentru plățile cu refund parțial. Exemplu: Partially Refunded
• După completarea câmpurilor, reveniți sus în pagină și accesați butonul “Save”

Gestionarea plăților

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

1.  Capture: Pentru încasarea tranzacțiilor realizate prin 2-phase (2-Phase – Authorize) este necesar să accesați butonul “Capture”. Operațiunea de încasare (deposit) se poate realiza integral sau parțial, prin introducerea sumei în câmpul “Capture amount” si accesarea butonului “Capture”.
2. Cancel: Pentru anularea/reversarea unei plăți realizate prin 2-Phase (2-Phase – Authorize), este necesar să accesați butonul “Cancel”.
3. Refund: Pentru rambursarea parțială sau totală a unei plăți capturate/deposited, puteți introduce suma în câmpul “Refund amount”, urmat de accesarea butonului “Refund”.

Card On File

Această funcționalitate este disponibilă doar pentru comerciantii cu drepturi corespunzatoare în conformitate cu contractul de acceptare plăți.
Funcționalitatea de card on file se poate activa din pagina de configurare a modulului BT iPAY. După activarea acestei funcționalități, în pagina de checkout se va afișa un nou checkbox sub rezumatul comenzii care va permite clientului să aleagă opțiunea de a salva sau nu a informațiilor de card, pentru plăți ulterioare.
După o plată reușită cu această opțiune activată (de salvare a informațiilor de card), la efectuarea unei comenzi ulterioare, în pagina de checkout se va afișa clientului o casetă de selecție din lista proprie de carduri salvate, sau opțiunea de a efectua plata cu un nou card prin selectarea checkbox-ului “I want to pay with a new card”. Acest nou card poate fi de asemenea salvat, dacă se dorește, prin selectarea checkbox-ului “Save my card for future uses”.
Clientul poate să își gestioneze cardurile salvate din meniul contului de client, prin accesarea “My account à Bt Ipay Saved Cards”. Clientul are posibilitatea de a adăuga, șterge, activa sau dezactiva un card.

Dezinstalarea modulului

Pentru dezinstalarea pluginului BT iPAY, acesați meniul Extensions -> Extensions din zona de administrare OpenCart, iar în filtrul din “Choose the extension type” selectați “Payments”. Localizați pluginul în listă și apoi faceți click pe butonul de dezinstalare.

Pentru a elimina complet datele pluginului, ștergeți următoarele tabele de baze de date:

• (oc_)bt_ipay_payments
• (oc_)bt_ipay_cards 
• (oc_)bt_ipay_refunds

Link GitHub:  https://github.com/Banca-Transilvania/opencart_v4 

Link descărcare modul BT iPay: https://www.opencart.com/index.php?route=marketplace/extension/info&extension_id=46538&filter_search=bt%20ipay

Integrarea iPay folosind tehnologiile .NET este dezvoltat in parteneriat cu CityOn - Platforma integrata cu modulul iPay si recomandata pentru tranzactiile din Administratia Publica.