Cum se alege un protocol pentru conectarea unui terminal bancar la Torgsoft: BPOS, PosApi, SSI, JSON și OschadPAY

Atunci când un terminal bancar este conectat la Torgsoft, casierul nu trebuie să introducă manual suma cumpărăturii pe terminal: în Torgsoft se selectează plata cu cardul, programul transmite suma către terminal și primește rezultatul operațiunii. Acest mod de lucru se numește integrarea terminalului bancar cu casa de marcat sau integrare cu sistemul de casă. 

Antreprenorii întreabă de obicei ce protocol trebuie solicitat de la bancă, dacă este compatibil un anumit model de terminal, ce variantă este mai potrivită pentru o casă locală sau un server la distanță, dacă este necesară o adresă IP statică și cum se poate lucra cu mai multe Persoane fizice autorizate printr-un singur terminal. Din solicitările către suportul tehnic reiese că problema principală nu este găsirea celui mai «bun» protocol, ci alegerea și configurarea corectă a aceleiași metode de conectare între bancă, terminal și Torgsoft.

Ce este protocolul terminalului bancar

Protocolul este modul în care Torgsoft și terminalul bancar fac schimb de date.

De exemplu, Torgsoft transmite terminalului:

• suma de plată;

• comanda pentru plată sau rambursare;

• dacă este necesar — datele comerciantului.

Terminalul returnează rezultatul operațiunii și datele disponibile ale plății.

Torgsoft acceptă diferite metode de integrare, inclusiv BPOS, PosApi, SSIAxECR, SSI_JSON, WebSocket/JSON, JSON (COM/TCP), OschadPAY, BankCore, QRPayMono și alte variante actuale. Pentru unele protocoale, banca trebuie să furnizeze drivere sau biblioteci.

 Este important să nu confundați trei lucruri:

• protocolul — modul în care Torgsoft și terminalul fac schimb de comenzi;

• conexiunea — modul în care acestea sunt conectate fizic sau prin rețea: USB/COM, Ethernet, Wi-Fi;

• comerciantul — identificatorul bancar al comerciantului, asociat unei anumite Persoane fizice autorizate și unui anumit cont.

Astfel, terminalul poate funcționa prin Wi-Fi, utilizând în același timp BPOS sau JSON. Wi-Fi nu este un protocol de acceptare a plăților.

Regula principală pentru alegerea protocolului

Nu trebuie să alegeți independent BPOS, PosApi sau JSON doar după denumirea băncii sau modelul terminalului.

Mai întâi trebuie să aflați de la bancă:

1. Dacă acest terminal poate funcționa în regim de integrare cu casa.

2. Ce protocol exact poate configura banca pe acest terminal.

3. Cum va fi conectat terminalul: USB/COM, Ethernet sau Wi-Fi.

4. Ce drivere și biblioteci oferă banca pentru integrare.

5. Dacă sunt configurați comercianții necesari pentru plată și rambursare.

După aceasta, în Torgsoft se selectează protocolul corespunzător.

Aceasta nu este o simplă formalitate. În suportul tehnic a existat un caz cu un terminal Newland N950 de la PrivatBank: terminalul în sine funcționa corect, însă nu a putut fi conectat la Torgsoft deoarece banca nu configurase dispozitivul pentru funcționarea în regim de integrare cu casa. Clientului i s-a recomandat să contacteze banca și să configureze JSON prin Wi-Fi.

Prin urmare, un model compatibil de terminal nu este suficient. Pe acesta trebuie configurat corect și regimul necesar de funcționare.

Pe scurt: prin ce se deosebesc principalele variante

Nu are sens să le comparați după principiul «acesta este mai bun, acesta este mai slab». Este necesară varianta pe care o acceptă simultan banca, echipamentul concret și Torgsoft.

BPOS și BPOS1

Pentru BPOS, banca oferă driverele necesare și biblioteca ECRCommX.dll. Torgsoft acceptă acest protocol pentru integrarea cu terminalele bancare.

BPOS are o particularitate importantă: în practică sunt întâlnite două regimuri.

Acest lucru este important în situația în care plata a fost finalizată pe terminal, dar programul, din cauza unei erori de conexiune, nu a primit sau nu a confirmat rezultatul. În instrucțiunea de conectare a terminalelor POS PrivatBank este descrisă exact această diferență dintre BPOS și BPOS1.

Antreprenorul nu trebuie să «comute BPOS la BPOS1» în mod independent. Dacă apar neconcordanțe între rezultatul de pe terminal și cel din casă, trebuie verificat cu banca ce regim este configurat.

În solicitările către suportul tehnic Torgsoft, BPOS este întâlnit și la conectarea în rețea a terminalelor Ingenico prin Ethernet: se configura portul, se rezerva adresa IP a terminalului și se verifica conexiunea.

Când se alege BPOS

Dacă banca informează că terminalul concret funcționează prin BPOS pentru integrarea cu casa și oferă componentele necesare pentru conectare, acest protocol poate fi utilizat în Torgsoft.

Dacă casa funcționează de la distanță prin RDP, este recomandat să informați imediat banca și suportul tehnic Torgsoft: într-un astfel de scenariu devin importante nu doar protocolul, ci și conexiunea de rețea și confirmarea corectă a operațiunilor.

PosApi

În Torgsoft, PosApi este acceptat ca protocol separat. Pentru acesta sunt necesare driverul terminalului și biblioteca Posapi.dll, furnizate pentru echipamentul bancar corespunzător. În documentația actuală Torgsoft există, printre altele, o instrucțiune separată pentru Verifone VX520 de la Raiffeisen Bank.

Pentru antreprenor, logica este simplă: banca spune că terminalul funcționează cu casa prin PosApi → banca oferă software-ul necesar → în Torgsoft se configurează PosApi.

Nu este necesar să alegeți PosApi doar pentru că terminalul aparține unui anumit brand. În documentația actuală Torgsoft se precizează separat că rubrica privind tipul terminalului bancar are caracter auxiliar, iar algoritmul de funcționare este determinat de protocolul selectat.

SSI: SSIAxECR și SSI_JSON

În Torgsoft există două variante separate:

• SSIAxECR;

• SSI_JSON.

Acestea nu trebuie considerate o singură setare interschimbabilă.

De exemplu, în documentația Torgsoft există o instrucțiune separată SSIAxECR pentru Verifone X990, iar SSI_JSON se configurează ca un alt protocol.

De aceea, atunci când primiți terminalul, nu este suficient să întrebați banca: «Avem SSI?». Trebuie să precizați denumirea exactă a protocolului configurat pe dispozitiv.

Ce trebuie să întrebați banca

Este suficient să formulați astfel: "Terminalul trebuie integrat cu programul de casă Torgsoft. Vă rugăm să precizați ce protocol SSI este configurat: SSIAxECR sau SSI_JSON și să ne furnizați parametrii pentru conectare".

Acest lucru este mult mai util decât să încercați să selectați singur setările în program.

JSON: o singură denumire, mai multe variante

În cazul JSON, antreprenorii se încurcă cel mai des deoarece JSON nu reprezintă o singură setare a terminalului.

În Torgsoft există, printre altele:

• WebSocket/JSON;

• JSON (COM/TCP).

Pentru WebSocket/JSON, documentația prevede componente separate pentru conexiunea de rețea și USB/COM. Pentru JSON (COM/TCP) se utilizează o altă metodă de schimb de date.

Prin urmare, răspunsul băncii «terminalul funcționează prin JSON» nu este suficient. Trebuie să precizați:

• ce variantă exactă de JSON este utilizată;

• dacă este vorba despre USB/COM sau o conexiune de rețea;

• în cazul conexiunii prin rețea — adresa IP și portul;

• dacă terminalul a fost deja configurat de bancă pentru funcționarea cu casa.

Acest lucru este confirmat de experiența suportului tehnic. În cazul Newland N950 de la PrivatBank au fost întâlnite atât conexiuni Wi-Fi în rețeaua locală, cât și alte variante de integrare. Suportul tehnic a verificat adresa IP, setările routerului și conexiunea cu terminalul.

Prin urmare, formula «Newland = JSON = orice setări sunt potrivite» este incorectă. Trebuie să știți exact cum a fost configurat de bancă dispozitivul respectiv.

OschadPAY: un scenariu separat cu smartphone-ul

OschadPAY diferă de BPOS, PosApi și alte variante destinate terminalelor POS obișnuite.

Integrarea Torgsoft cu OschadPAY a fost adăugată pentru acceptarea plăților contactless prin smartphone. Telefonul cu funcționalitatea corespunzătoare este utilizat pentru acceptarea plăților cu cardul fără un terminal POS staționar separat.

Prin urmare, OschadPAY merită luat în considerare dacă este necesar exact un astfel de scenariu, de exemplu pentru o casă mobilă sau pentru activități comerciale în care instalarea unui terminal bancar separat este incomodă.

Dacă magazinul a primit de la Oschadbank un terminal POS obișnuit, nu trebuie selectat automat OschadPAY. Mai întâi trebuie să precizați la bancă ce metodă de integrare cu casa este utilizată pentru echipamentul furnizat.

USB, Ethernet sau Wi-Fi

Protocolul și metoda de conectare trebuie selectate împreună.

Dacă Torgsoft funcționează pe computerul de lângă casă

USB/COM poate fi convenabil dacă banca a prevăzut această metodă de conectare pentru terminalul respectiv.

În acest scenariu nu există o rută separată de rețea între program și terminal.

Dacă terminalul funcționează prin Ethernet sau Wi-Fi

Terminalul are propria adresă IP în rețea. Este important ca aceasta să nu se modifice în mod neașteptat.

În solicitările reale, suportul tehnic:

• verifică adresa IP a terminalului;

• rezervă adresa în router;

• verifică portul necesar;

• verifică disponibilitatea dispozitivului;

• după aceasta efectuează o plată de test.

Dacă routerul atribuie terminalului o altă adresă IP, Torgsoft poate pur și simplu să nu-l mai găsească, chiar dacă terminalul POS continuă să funcționeze ca terminal bancar separat.

Ce se schimbă atunci când se lucrează printr-un server la distanță sau RDP

Aici este important să înțelegeți unde se află cele două dispozitive:

• terminalul POS se află fizic în magazin;

• Torgsoft poate funcționa pe un server aflat în altă locație.

Prin urmare, serverul trebuie să poată transmite comanda către terminalul din magazin și să primească răspunsul.

Din acest motiv, atunci când se lucrează de la distanță, trebuie verificate:

• protocolul utilizat;

• dacă acesta acceptă scenariul de rețea ales;

• adresa IP a terminalului;

• portul necesar;

• setările routerului și ale firewall-ului;

• accesibilitatea terminalului din mediul în care funcționează Torgsoft.

În solicitările către suportul tehnic există cazuri în care conexiunea cu POS-ul lipsea tocmai din cauza parametrilor de rețea sau a modificării adresei IP. Există și un caz în care pentru funcționarea magazinului a fost necesară o adresă IP statică.

Însă regula «pentru orice RDP trebuie obligatoriu să cumpărați o adresă IP statică externă și să configurați Port Forwarding» este incorectă. Totul depinde de modul în care este construită rețeaua concretă. Mai întâi trebuie stabilită schema de conectare.

Dacă mai multe Persoane fizice autorizate lucrează cu un singur terminal

Protocolul în sine nu rezolvă această problemă.

Pentru fiecare antreprenor trebuie configurată corect legătura: Persoană fizică autorizată → cont curent → comerciant → terminal bancar.

În solicitările către suportul tehnic apar în mod regulat:

• adăugarea unei noi Persoane fizice autorizate;

• verificarea disponibilității acesteia în terminal;

• adăugarea comerciantului corespunzător în Torgsoft;

• configurarea legăturilor cu conturile;

• verificarea plății și rambursării.

Dacă banca nu a adăugat comerciantul necesar în terminal, nu este suficient să îl configurați doar în Torgsoft.

Acest lucru trebuie verificat înainte de începerea activității casei, nu după ce prima plată a ajuns în contul altei Persoane fizice autorizate.

De ce terminalul este conectat, dar plata funcționează totuși incorect

Faptul că Torgsoft detectează terminalul înseamnă doar că a fost stabilită conexiunea.

După conectare pot rămâne alte probleme:

• a fost selectat comerciantul greșit;

• terminalul a fost configurat de bancă pentru alt regim;

• programul și POS-ul au interpretat diferit rezultatul operațiunii;

• plata funcționează, dar rambursarea nu este configurată;

• după schimbarea routerului, terminalul a primit o altă adresă IP.

Prin urmare, după configurare trebuie verificată nu doar conexiunea, ci întregul ciclu de lucru.

Cum se verifică corect terminalul după conectare

După configurare, este recomandat să efectuați un test scurt.

1. Verificați conexiunea cu terminalul.

2. Efectuați o plată de test de valoare mică.

3. Verificați dacă suma a fost transmisă automat din Torgsoft.

4. Verificați Merchant ID și Persoana fizică autorizată necesară.

5. Asigurați-vă că vânzarea s-a finalizat corect în Torgsoft.

6. Verificați bonul fiscal dacă se utilizează CM/PCM.

7. Efectuați o rambursare de test.

8. Asigurați-vă că banii și documentele sunt reflectate corect.

Baza de cunoștințe Torgsoft recomandă efectuarea unei plăți de test, verificarea comerciantului și efectuarea unei rambursări de test după configurarea terminalului bancar.

Astfel poate fi identificată imediat situația în care vânzarea funcționează, iar rambursarea — nu.

Ce trebuie să comunicați băncii înainte de a primi terminalul

Antreprenorul nu trebuie să cunoască toate diferențele tehnice dintre BPOS, SSI sau JSON.

Este suficient să transmiteți băncii o cerință concretă: "Avem nevoie de un terminal bancar pentru integrarea cu programul Torgsoft în regim de integrare cu casa. Vă rugăm să ne comunicați ce protocol de integrare este disponibil pentru acest model și această bancă, cum se conectează terminalul la casă și ce drivere, biblioteci și parametri trebuie să obținem pentru conectare".

Dacă Torgsoft funcționează printr-un server la distanță, acest lucru trebuie menționat imediat.

Dacă mai multe Persoane fizice autorizate vor utiliza același terminal, acest lucru trebuie de asemenea convenit cu banca înainte de configurare.

Cum se alege protocolul: schemă practică

◆ Dacă terminalul există deja, aflați mai întâi de la bancă ce protocol de integrare cu casa este configurat pe acesta. Apoi comparați-l cu protocoalele acceptate de Torgsoft.

◆ Dacă urmează să comandați terminalul, informați banca că este necesară integrarea cu Torgsoft și precizați protocolul disponibil și metoda de conectare.

◆ Dacă Torgsoft funcționează pe un server la distanță, la alegerea protocolului adăugați verificarea accesului prin rețea la POS.

◆ Dacă lucrează mai multe Persoane fizice autorizate, conveniți separat cu banca comercianții pentru fiecare întreprindere.

◆ Dacă este necesară plata cu smartphone-ul fără un POS separat, OschadPAY poate fi luat în considerare ca scenariu separat.

Principalul lucru

Nu trebuie să alegeți BPOS, PosApi, SSI sau JSON după principiul «care este mai modern». Protocolul corect pentru magazin este cel pe care banca l-a configurat pe terminalul concret, pe care Torgsoft îl acceptă și pentru care schema de conectare aleasă permite transmiterea stabilă a plății și primirea rezultatului.

Înainte de lansarea casei este suficient să verificați cinci lucruri: protocolul → metoda de conectare → IP/port, dacă este necesar → comerciantul → plata și rambursarea de test.

Aceste puncte determină cel mai frecvent dacă integrarea va funcționa corect în activitatea zilnică a magazinului.