Knowledgebase

Configurare BT ePOS / eCommerce (plata cu cardul)

Introducere

Modulul BT ePOS / eCommerce permite încasarea cu cardul a facturilor proforme și a facturilor fiscale, prin platforma de plăți a Băncii Transilvania. Se configurează din Setări → ePayments → BT ePOS și, odată activat, adaugă un buton de plată pe documentele emise.

BT ePOS face parte din familia de procesatoare de plăți integrate în BOCP, alături de Netopia Payments, EuPlătesc, PlătiOnline, ING WebPay, LibraPay și Stripe. Spre deosebire de majoritatea acestora, BT ePOS oferă și posibilitatea de a bloca suma pe cardul clientului și de a o încasa mai târziu, după ce comanda a fost pregătită pentru livrare, precum și plata parțială cu puncte StarBT.

Ce găsești în acest articol

Activarea contului la Banca Transilvania

Pasul 1. Se solicită băncii activarea unui cont BT ePOS pentru plățile cu cardul. Banca trimite prin email credențialele de test:

  • Credențiale pentru consola de administrare — se folosesc pe https://ecclients.btrl.ro:5443/console/index.html#login pentru vizualizarea istoricului tranzacțiilor.
  • Credențiale API — se introduc în configurarea modulului din BOCP.

Pentru testare, în regimul de lucru Mod Testare, banca pune la dispoziție un card fictiv, folosit în comun de mai mulți comercianți:

  • Card: 4119881000346430, expirare 04/23, cod 183
  • Prima parolă 3DS (ecranul „Codul SMS”): 12345
  • Parola statică (ecranul „Parola unică”): Parola123$

Atenție: Testele se fac cu sume mici, sub 100 lei.

Pasul 2. După efectuarea testelor pe o factură proformă, se notifică prin email reprezentantul băncii, specificând numărul comenzii de pe site, numărul facturii proforme și numărul de referință al încasării (numit morder de către bancă). Se solicită credențialele pentru mediul de producție.

Pasul 3. După ce banca aprobă testele și trimite datele, se completează credențialele live și se comută regimul de lucru pe Mod Live.

Configurarea modulului în BOCP

Se intră în Setări → ePayments → BT ePOS.

[Ecran: pagina de configurare BT ePOS din Setări → ePayments]

  • MODUL ACTIVAT — comutatorul principal. Când este bifat, apare butonul de plată pe proforme și pe facturile fiscale.
  • Încasare forțată în RON indiferent de valuta facturii — se bifează dacă banca nu acceptă încasări în alte valute.
  • Cont bancar de decont — contul în care se înregistrează încasările. Dacă nu se selectează niciunul, încasarea se rezolvă manual.
  • Tip de plată utilizat — vezi secțiunea următoare.
  • Mod de depozitare a sumei autorizate — vezi secțiunea următoare.
  • Credențiale API (utilizator și parolă) — cele primite de la bancă, corespunzătoare regimului de lucru ales.
  • Prefix unic comandă — un text scurt care identifică firma în numerele de comandă trimise băncii.
  • Regim de lucru — Mod Testare până la aprobarea băncii, apoi Mod Live.

Atenție: În Mod Testare butonul de plată nu apare pe documentele reale, tocmai pentru ca un client să nu ajungă din greșeală în mediul de test al băncii. Butonul reapare după comutarea pe Mod Live cu credențiale de producție completate.

Tip de plată: încasare imediată sau blocare pe card

Opțiunea Tip de plată utilizat stabilește ce se întâmplă cu banii în momentul în care clientul plătește:

  • 1-phase — suma este autorizată și încasată în același moment. Recomandat pentru servicii livrate imediat, abonamente, taxe.
  • 2-phase — suma este doar blocată pe cardul clientului, iar încasarea efectivă se face într-un pas separat. Recomandat pentru produse fizice, unde există riscul să nu existe stoc sau să nu se poată livra.

Când este ales 2-phase, opțiunea Mod de depozitare a sumei autorizate stabilește cine face încasarea:

  • Automat (implicit) — suma se încasează imediat, la momentul plății. Este comportamentul folosit până acum și rămâne activ dacă nu se schimbă nimic.
  • Manual — suma rămâne blocată, iar un operator o încasează din lista de plăți cu cardul, după ce confirmă că comanda poate fi livrată.

Încasarea manuală a sumei blocate

Cu Tip de plată 2-phase și Mod de depozitare Manual, plata clientului lasă suma blocată pe card, iar documentul rămâne neîncasat până la confirmarea operatorului.

Se intră în Tranzacții → Plăți cu cardul. Plățile cu sumă blocată au starea APPROVED și afișează pe rând, în coloana Încasare, un buton dedicat.

[Ecran: lista Plăți cu cardul, cu coloana Încasare și butonul pe un rând cu starea APPROVED]

  1. Se apasă butonul din coloana Încasare, care deschide fișa plății.
  2. Se apasă Încasează suma autorizată și se confirmă.
  3. După confirmare, plata trece în starea DEPOSITED, se înregistrează încasarea în contul bancar configurat, iar documentul apare ca achitat.

Atenție: Încasarea trebuie făcută în cel mult 5 zile de la plata clientului. După acest termen banca nu mai garantează că suma blocată poate fi încasată, iar banii se deblochează singuri pe cardul clientului — comanda rămâne astfel neplătită.

Notă: O sumă blocată nu poate fi încasată de două ori. Dacă butonul este apăsat a doua oară, sau dacă altcineva a încasat deja între timp, apare un mesaj care anunță că operațiunea nu mai este posibilă.

Anularea preautorizării

Dacă comanda nu poate fi onorată — produsul nu este în stoc, livrarea nu este posibilă, clientul renunță — suma blocată se eliberează în loc să fie încasată. Din aceeași fișă a plății se apasă Anulează preautorizarea și se confirmă.

Atenție: Anularea este integrală, nu parțială: se eliberează toată suma blocată, iar plata nu mai poate fi încasată ulterior. Pentru o comandă onorată parțial se încasează suma corespunzătoare, iar diferența se eliberează automat.

Notă: Anularea se face de preferință în primele 24 de ore de la plată, dacă este clar că comanda nu se poate onora. Anularea unei preautorizări nu este același lucru cu returnarea banilor — returnarea se aplică doar unei sume deja încasate.

Plata parțială cu puncte StarBT

Clienții care dețin card Banca Transilvania cu puncte StarBT pot achita o parte din valoarea comenzii în puncte, direct în pagina de plată a băncii. Nu este nevoie de nicio configurare suplimentară în BOCP, dar comerciantul trebuie să aibă acest serviciu activat la bancă.

Într-o astfel de plată, suma se împarte în două: partea achitată în lei și partea achitată în puncte. În BOCP plata apare ca o singură încasare, cu valoarea totală a documentului, iar operațiunile de încasare, anulare și returnare acoperă automat ambele părți.

Notă: Plata cu puncte este disponibilă doar pentru documentele în lei. Pentru facturi în euro sau dolari, opțiunea nu apare clientului.

Atenție: La o returnare parțială a unei plăți făcute și cu puncte, banca returnează întâi partea în puncte. Exemplu: la o comandă de 48,08 lei achitată cu 38,08 lei și 10 lei în puncte, o returnare de 10 lei se face integral din puncte, nu din bani.

Returnarea banilor

Pentru o plată deja încasată, returnarea se face din Tranzacții → Plăți cu cardul: se deschide fișa plății și se apasă Returnare plată. Se completează suma de returnat, care poate fi totală sau parțială, și se salvează.

După confirmarea băncii, în BOCP se înregistrează automat o tranzacție cu valoare negativă, iar câmpul Suma deja returnată din fișa plății se actualizează. Returnările se pot repeta până la epuizarea sumei încasate.

Notă: Se poate returna doar o sumă deja încasată. Pentru o sumă doar blocată pe card se folosește Anulează preautorizarea.

Probleme frecvente și soluții

  • Nu apare butonul de plată pe proformă, deși modulul este activat — cea mai frecventă cauză este că proforma provine dintr-o comandă cu plata ramburs. În acest caz documentul afișează secțiunea de plată offline, nu butonul de card. Verificați metoda de plată a comenzii.
  • Butonul de plată a dispărut după generarea AWB-ului — dacă s-a generat deja un AWB cu plata ramburs, plata cu cardul este dezactivată pentru documentul respectiv, ca să nu fie încasat de două ori.
  • Butonul nu apare pentru facturile mari — verificați plafonul maxim pentru plata cu cardul din setările generale de ePayments. Peste plafon, butonul nu se afișează.
  • Butonul nu apare deloc, iar regimul de lucru este Mod Testare — este comportamentul corect. În Mod Testare butonul este disponibil doar pentru testele interne, nu pe documentele clienților.
  • Clientul a plătit, dar documentul apare neîncasat — dacă tipul de plată este 2-phase cu depozitare manuală, acesta este comportamentul așteptat: suma este blocată și trebuie încasată din lista de plăți cu cardul. Verificați starea plății — APPROVED înseamnă blocată, DEPOSITED înseamnă încasată.
  • Mesaj de eroare la încasare sau la returnare — mesajul afișat este cel primit de la bancă. Fișa plății păstrează istoricul complet al comunicării cu banca, util la sesizarea către reprezentantul BT.

De știut

Atenție: Cu tipul de plată 2-phase și depozitare manuală, o sumă blocată și neîncasată nu produce niciun venit. Clientul vede banii rezervați pe card, iar comerciantul nu îi primește. Lista Tranzacții → Plăți cu cardul trebuie verificată zilnic pentru plățile rămase în starea APPROVED.

Notă: Dacă un client reintră pe pagina de confirmare a plății sau reactualizează pagina, plata nu se dublează și nu se retrimite un al doilea email de confirmare.

Notă: Pentru înregistrarea încasării în contabilitate este necesar ca Contul bancar de decont să fie completat în configurarea modulului. Fără el, încasările trebuie alocate manual.

Was this article helpful?

★ ★ ★ ★ ★