Ako si vybrať protokol na pripojenie bankového terminálu k Torgsoftu: BPOS, PosApi, SSI, JSON a OschadPAY

Keď je bankový terminál pripojený k Torgsoft, pokladník nemusí zadávať sumu nákupu do terminálu ručne: v Torgsoft sa vyberie platba kartou, program odošle sumu do terminálu a prijme výsledok operácie. Tento spôsob práce sa nazýva integrácia bankového terminálu s pokladňou alebo pokladničná integrácia. 

Podnikatelia sa najčastejšie pýtajú, aký protokol si majú objednať v banke, či je vhodný konkrétny model terminálu, čo je lepšie pre lokálnu pokladňu alebo vzdialený server, či je potrebná statická IP adresa a ako pracovať s viacerými Živnostníkmi prostredníctvom jedného terminálu. Požiadavky na technickú podporu ukazujú, že hlavnou otázkou nie je nájsť «najlepší» protokol, ale správne zosúladiť rovnaký spôsob pripojenia medzi bankou, terminálom a Torgsoft.

Čo je protokol bankového terminálu

Protokol je spôsob, akým si Torgsoft a bankový terminál vymieňajú údaje.

Torgsoft napríklad odosiela do terminálu:

• sumu na úhradu;

• príkaz na platbu alebo vrátenie platby;

• v prípade potreby údaje obchodníka.

Terminál vráti výsledok operácie a dostupné údaje o platbe.

Torgsoft podporuje rôzne spôsoby integrácie vrátane BPOS, PosApi, SSIAxECR, SSI_JSON, WebSocket/JSON, JSON (COM/TCP), OschadPAY, BankCore, QRPayMono a ďalších aktuálnych možností. Pre niektoré protokoly musí banka poskytnúť ovládače alebo knižnice.

 Je dôležité nezamieňať si tri veci:

• protokol — spôsob, akým si Torgsoft a terminál vymieňajú príkazy;

• pripojenie — spôsob, akým sú fyzicky alebo sieťovo prepojené: USB/COM, Ethernet, Wi-Fi;

• merchant — identifikátor obchodníka v banke, ktorý je prepojený s konkrétnym Živnostníkom a účtom.

Terminál teda môže fungovať cez Wi-Fi a zároveň používať BPOS alebo JSON. Wi-Fi nie je protokol na prijímanie platieb.

Hlavné pravidlo pri výbere protokolu

BPOS, PosApi ani JSON by ste nemali vyberať samostatne iba podľa názvu banky alebo modelu terminálu.

Najprv si v banke overte:

1. Či môže tento terminál fungovať v režime pokladničnej integrácie.

2. Aký konkrétny protokol môže banka na tomto termináli nastaviť.

3. Ako bude terminál pripojený: USB/COM, Ethernet alebo Wi-Fi.

4. Aké ovládače a knižnice poskytuje banka na integráciu.

5. Či sú nastavené potrebné merchanty na platby a vrátenia platieb.

Potom sa v Torgsoft vyberie zodpovedajúci protokol.

Nie je to iba formalita. Technická podpora Torgsoft riešila prípad s terminálom Newland N950 od PrivatBank: samotný terminál fungoval správne, ale nebolo ho možné pripojiť k Torgsoftu, pretože banka zariadenie nenastavila na prácu v režime pokladničnej integrácie. Klientovi bolo odporučené kontaktovať banku a nastaviť JSON cez Wi-Fi.

Samotný kompatibilný model terminálu preto nestačí. Na termináli musí byť správne nastavený aj potrebný prevádzkový režim.

Stručne: ako sa líšia hlavné možnosti

Nemá zmysel porovnávať ich podľa princípu, že jeden je «lepší» a druhý «horší». Potrebujete možnosť, ktorú súčasne podporuje banka, konkrétne zariadenie a Torgsoft.

BPOS a BPOS1

Pre BPOS banka poskytuje potrebné ovládače a knižnicu ECRCommX.dll. Torgsoft podporuje tento protokol na integráciu s bankovými terminálmi.

BPOS má jednu dôležitú vlastnosť: v praxi sa používajú dva režimy.

Je to dôležité v situácii, keď bola platba na termináli dokončená, ale program pre chybu komunikácie neprijal alebo nepotvrdil výsledok. V návode na pripojenie POS terminálov PrivatBank je opísaný práve tento rozdiel medzi BPOS a BPOS1.

Podnikateľ nemusí samostatne «prepínať BPOS na BPOS1». Ak sa výsledok na termináli nezhoduje s výsledkom v pokladni, overte si v banke, ktorý režim je nastavený.

V požiadavkách na technickú podporu Torgsoft sa BPOS používa aj pri sieťovom pripojení terminálov Ingenico cez Ethernet: nastavoval sa port, rezervovala sa IP adresa terminálu a kontrolovalo sa pripojenie.

Kedy vybrať BPOS

Ak banka potvrdí, že konkrétny terminál používa na pokladničnú integráciu BPOS a poskytne potrebné komponenty na pripojenie, tento protokol možno použiť v Torgsoft.

Ak pokladňa funguje vzdialene cez RDP, informujte o tom banku a technickú podporu Torgsoft hneď na začiatku: v takomto scenári je dôležitý nielen protokol, ale aj sieťové pripojenie a správne potvrdenie transakcií.

PosApi

Torgsoft podporuje PosApi ako samostatný protokol. Vyžaduje ovládač terminálu a knižnicu Posapi.dll, ktoré sa poskytujú pre príslušné bankové zariadenie. Aktuálna dokumentácia Torgsoft obsahuje okrem iného samostatný návod pre Verifone VX520 od Raiffeisen Bank.

Pre podnikateľa je logika jednoduchá: banka oznámi, že terminál komunikuje s pokladňou cez PosApi → banka poskytne potrebný softvér → v Torgsoft sa nastaví PosApi.

PosApi nie je potrebné vyberať iba preto, že terminál vyrába určitý výrobca. V aktuálnej dokumentácii Torgsoft sa osobitne uvádza, že pole typu bankového terminálu je pomocné, zatiaľ čo algoritmus fungovania určuje zvolený protokol.

SSI: SSIAxECR and SSI_JSON

Torgsoft obsahuje dve samostatné možnosti:

• SSIAxECR;

• SSI_JSON.

Nemali by sa považovať za jedno vzájomne zameniteľné nastavenie.

Dokumentácia Torgsoft napríklad obsahuje samostatný návod SSIAxECR pre Verifone X990, zatiaľ čo SSI_JSON sa nastavuje ako iný protokol.

Preto pri prevzatí terminálu nestačí opýtať sa banky: «Máme SSI?». Je potrebné upresniť presný názov protokolu nastaveného na zariadení.

Čo sa opýtať banky

Stačí povedať: "Terminál potrebujeme integrovať s pokladničným programom Torgsoft. Prosíme o upresnenie, ktorý protokol SSI je nastavený: SSIAxECR alebo SSI_JSON, a o poskytnutie parametrov pripojenia".

Je to oveľa užitočnejšie ako pokúšať sa samostatne vyberať nastavenia v programe.

JSON: jeden názov, niekoľko možností

JSON najčastejšie spôsobuje nejasnosti, pretože JSON nie je jedno konkrétne nastavenie terminálu.

Torgsoft obsahuje okrem iného:

• WebSocket/JSON;

• JSON (COM/TCP).

Pre WebSocket/JSON dokumentácia uvádza samostatné komponenty pre sieťové pripojenie a USB/COM. JSON (COM/TCP) používa iný spôsob výmeny údajov.

Preto odpoveď banky, že «terminál funguje cez JSON», nestačí. Je potrebné upresniť:

• ktorá konkrétna možnosť JSON sa používa;

• či ide o USB/COM alebo sieťové pripojenie;

• pri sieťovom pripojení — IP adresu a port;

• či banka už prepla terminál do režimu pokladničnej integrácie.

Potvrdzuje to aj prax technickej podpory. Pri termináli Newland N950 od PrivatBank sa používalo pripojenie cez Wi-Fi v rámci lokálnej siete aj iné možnosti integrácie. Technická podpora kontrolovala IP adresu, nastavenia routera a spojenie s terminálom.

Preto je vzorec «Newland = JSON = fungovať budú akékoľvek nastavenia» nesprávny. Je potrebné presne vedieť, ako banka nastavila konkrétne zariadenie.

OschadPAY: samostatný scenár so smartfónom

OschadPAY sa líši od BPOS, PosApi a ďalších možností určených pre bežné POS terminály.

Integrácia Torgsoft s OschadPAY bola pridaná na prijímanie bezkontaktných platieb prostredníctvom smartfónu. Telefón so zodpovedajúcou funkciou sa používa na prijímanie platieb kartou bez samostatného stacionárneho POS terminálu.

OschadPAY preto stojí za zváženie vtedy, keď potrebujete práve tento scenár, napríklad pre mobilnú pokladňu alebo obchod, kde je inštalácia samostatného bankového terminálu nepraktická.

Ak obchod dostal od Oschadbank bežný POS terminál, OschadPAY by sa nemal vyberať automaticky. Najprv si v banke overte, aký spôsob pokladničnej integrácie sa používa pre poskytnuté zariadenie.

USB, Ethernet alebo Wi-Fi

Protokol a spôsob pripojenia je potrebné vyberať spoločne.

Ak Torgsoft funguje na počítači pri pokladni

USB/COM môže byť vhodné, ak banka pre daný terminál poskytuje tento spôsob pripojenia.

V tomto scenári medzi programom a terminálom nie je samostatná sieťová trasa.

Ak terminál funguje cez Ethernet alebo Wi-Fi

Terminál má v sieti vlastnú IP adresu. Je dôležité, aby sa neočakávane nemenila.

V reálnych požiadavkách technická podpora:

• kontroluje IP adresu terminálu;

• rezervuje adresu v routeri;

• kontroluje potrebný port;

• kontroluje dostupnosť zariadenia;

• následne vykoná testovaciu platbu.

Ak router pridelí terminálu inú IP adresu, Torgsoft ho môže jednoducho prestať nachádzať, hoci samotný POS terminál bude naďalej fungovať ako samostatný bankový terminál.

Čo sa mení pri práci cez vzdialený server alebo RDP

Tu je dôležité pochopiť, kde sa nachádzajú obe zariadenia:

• POS terminál sa fyzicky nachádza v predajni;

• Torgsoft môže fungovať na serveri na inom mieste.

Server preto musí byť schopný odoslať príkaz do terminálu v predajni a prijať odpoveď.

Pri vzdialenej práci je preto potrebné skontrolovať:

• aký protokol sa používa;

• či podporuje zvolený sieťový scenár;

• IP adresu terminálu;

• potrebný port;

• nastavenia routera a firewallu;

• či je terminál dostupný z prostredia, v ktorom funguje Torgsoft.

V záznamoch technickej podpory sú prípady, keď spojenie s POS terminálom nefungovalo práve pre sieťové parametre alebo zmenu IP adresy. Vyskytol sa aj prípad, keď bola na fungovanie predajne potrebná statická IP adresa.

Pravidlo «pri každom RDP je povinné zakúpiť externú statickú IP adresu a nastaviť Port Forwarding» však nie je správne. Závisí to od konkrétnej konfigurácie siete. Najprv je potrebné určiť schému pripojenia.

Ak jeden terminál používa viacero Živnostníkov

Samotný protokol túto otázku nerieši.

Pre každého podnikateľa musí byť správne nastavené prepojenie: Živnostník → bežný účet → merchant → bankový terminál.

Technická podpora Torgsoft pravidelne rieši požiadavky týkajúce sa:

• pridania nového Živnostníka;

• kontroly jeho dostupnosti v termináli;

• pridania príslušného merchanta v Torgsoft;

• nastavenia prepojení s účtami;

• kontroly platieb a vrátenia platieb.

Ak banka nepridala potrebného merchanta do terminálu, nestačí ho nastaviť iba v Torgsoft.

Je potrebné to skontrolovať pred spustením pokladne, nie až po tom, ako prvá platba príde na účet iného Živnostníka.

Prečo môže byť terminál pripojený, ale platba napriek tomu funguje nesprávne

Skutočnosť, že Torgsoft terminál vidí, znamená iba to, že bolo vytvorené spojenie.

Po pripojení môžu zostať ďalšie problémy:

• je vybraný nesprávny merchant;

• banka nastavila terminál na iný režim;

• program a POS terminál odlišne vyhodnotili výsledok operácie;

• platba funguje, ale vrátenie platby nie je nastavené;

• po výmene routera dostal terminál inú IP adresu.

Po nastavení preto treba skontrolovať nielen samotné pripojenie, ale celý pracovný proces.

Ako správne skontrolovať terminál po pripojení

Po nastavení je vhodné vykonať krátky test.

1. Skontrolujte pripojenie k terminálu.

2. Vykonajte malú testovaciu platbu.

3. Skontrolujte, či sa suma automaticky preniesla z Torgsoft.

4. Skontrolujte Merchant ID a správneho Živnostníka.

5. Uistite sa, že predaj bol v Torgsoft správne dokončený.

6. Ak sa používa RP/RRP, skontrolujte fiškálny pokladničný doklad.

7. Vykonajte testovacie vrátenie platby.

8. Uistite sa, že finančné prostriedky a dokumenty sú správne zaevidované.

Znalostná databáza Torgsoft odporúča po nastavení bankového terminálu vykonať testovaciu platbu, skontrolovať merchanta a vykonať testovacie vrátenie platby.

Takto možno okamžite odhaliť situáciu, keď predaj funguje, ale vrátenie platby nie.

Čo oznámiť banke pred prevzatím terminálu

Podnikateľ nemusí poznať všetky technické rozdiely medzi BPOS, SSI a JSON.

Stačí banke zadať konkrétnu požiadavku: "Potrebujem bankový terminál na integráciu s programom Torgsoft v režime pokladničnej integrácie. Prosím, oznámte mi, aký integračný protokol je dostupný pre tento model a túto banku, ako sa terminál pripája k pokladni a aké ovládače, knižnice a parametre sú potrebné na pripojenie".

Ak Torgsoft funguje cez vzdialený server, treba to uviesť hneď.

Ak bude jeden terminál používať viacero Živnostníkov, aj toto treba s bankou dohodnúť ešte pred nastavením.

Ako vybrať protokol: praktická schéma

◆ Ak už terminál máte, najprv si v banke overte, aký protokol pokladničnej integrácie je na ňom nastavený. Potom ho porovnajte s protokolmi podporovanými Torgsoft.

◆ Ak terminál ešte len objednávate, oznámte banke, že potrebujete integráciu s Torgsoft, a zistite dostupný protokol a spôsob pripojenia.

◆ Ak Torgsoft funguje na vzdialenom serveri, pri výbere protokolu skontrolujte aj sieťový prístup k POS terminálu.

◆ Ak používate viacero Živnostníkov, dohodnite s bankou osobitne merchanty pre každého podnikateľa.

◆ Ak potrebujete platby smartfónom bez samostatného POS terminálu, OschadPAY možno zvážiť ako samostatný scenár.

Hlavné pravidlo

BPOS, PosApi, SSI ani JSON nie je potrebné vyberať podľa toho, ktorý z nich je «modernejší». Správny protokol pre predajňu je ten, ktorý banka nastavila na konkrétnom termináli, ktorý Torgsoft podporuje a pri ktorom zvolená schéma pripojenia umožňuje spoľahlivo odosielať platby a prijímať výsledky operácií.

Pred spustením pokladne stačí skontrolovať päť vecí: protokol → spôsob pripojenia → IP/port, ak sú potrebné → merchant → testovacia platba a vrátenie platby.

Práve tieto body najčastejšie rozhodujú o tom, či bude integrácia pri každodennej prevádzke predajne fungovať správne.