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
- 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:
- 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”.
- Cancel: Pentru anularea/reversarea unei plăți realizate prin 2-Phase (Authorize), este necesar să accesați butonul “Cancel” din tabul BT Ipay.
- 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
Descarcă modulul iPay BT IPAY - WooCommerce user manual .pdf