Instrucțiuni pentru conectarea terminalului Android PAX A930 la Torgsoft prin protocolul JSON prin Wi-Fi. Terminalul PAX A930 poate funcționa cu Torgsoft în două moduri diferite:
1.
direct prin JSON (COM/TCP) — aceasta este opțiunea recomandată și mai stabilă;
2.
prin WebSocket și aplicația «Integrare casă» — aceasta este o metodă mai veche și mai puțin stabilă.
Înainte de configurare, asigurați-vă că ați clarificat exact ce mod a activat banca.
Acest ghid presupune modificarea setărilor terminalului bancar, ale rețelei și ale parametrilor de integrare din Torgsoft, de aceea trebuie urmat cu atenție. Dacă sunt confundate modul de conectare, adresa IP, portul sau tipul de protocol, terminalul poate înceta complet să mai accepte comenzi de la casa de marcat, iar plățile pot începe să se finalizeze cu timeout-uri sau cu eroarea DeviceBusy. Înainte de a face orice modificări, asigurați-vă că banca v-a comunicat deja în ce mod trebuie să funcționeze terminalul — JSON direct sau WebSocket prin aplicația «Integrare casă». Dacă nu aveți acces la setările de rețea sau la parametrii terminalului, contactați suportul tehnic al băncii sau administratorul de sistem.
Când este necesară conectarea sau reconfigurarea PAX A930
•
La conectarea prin Wi-Fi sau Ethernet: după schimbarea routerului, a furnizorului de internet sau a setărilor rețelei locale (când se schimbă adresa IP).
•
La conectarea prin USB: după schimbarea portului COM. Acest lucru se întâmplă la înlocuirea calculatorului, la utilizarea unui alt adaptor USB sau dacă pur și simplu cablul terminalului a fost introdus într-un alt port USB și nu se mai știe unde era conectat anterior.
•
Dacă apar erori de comunicare («Dispozitiv ocupat», timeout-uri).
Conform practicii echipei de suport tehnic, la conectarea prin cablu (USB) numărul portului COM este adesea schimbat automat de sistemul de operare Windows dacă acest cablu este introdus într-un alt conector sau dacă este utilizat un adaptor nou. În acest caz, Torgsoft «pierde» terminalul, astfel încât setările trebuie actualizate. Modificările pentru Wi-Fi/Ethernet privesc exclusiv parametrii de rețea (IP, router, porturi).
Cum să înțelegeți că terminalul este configurat incorect
•
Eroarea DeviceBusy («Dispozitiv ocupat») la încercarea de plată.
•
Mesajul «Timpul de așteptare pentru răspuns a expirat» (banii au fost retrași, dar bonul nu a fost emis).
•
Terminalul nu se «trezește» atunci când apăsați butonul «Plătește» în casa de marcat.
De ce PAX A930 pierde conexiunea cu Torgsoft
•
Schimbarea adresei IP a terminalului (DHCP) după repornirea routerului.
•
Aplicația «Integrare casă» nu este pornită (sau a fost minimizată) pe terminal.
•
Blocarea porturilor 3000/2000 de către antivirus sau firewall.
•
Timeout-ul de așteptare din setările Torgsoft este prea mic.
Cum se configurează PAX A930 pentru a funcționa cu Torgsoft
1. Cum pregătiți rețeaua pentru funcționarea terminalului
•
Conectați PAX A930 la aceeași rețea Wi-Fi ca și calculatorul pe care rulează Torgsoft.
•
Obligatoriu: setați o adresă IP statică pe terminal sau rezervați-o în router după adresa MAC.
•
Risc: fără rezervarea IP, adresa terminalului se poate schimba după repornirea routerului sau după expirarea lease-ului DHCP, iar conexiunea cu Torgsoft se va pierde.
2. Ce metodă de conectare să utilizați
Metoda 1: Cum funcționează conectarea directă JSON (COM/TCP)
Aceasta este metoda modernă și mai fiabilă de integrare. Ea permite programului Torgsoft să comunice direct cu terminalul, fără a fi nevoie să instalați și să mențineți în funcțiune permanent programe intermediare suplimentare (de exemplu, servere WebSocket) pe calculatorul casierului.
•
Ce trebuie să faceți: contactați suportul tehnic al băncii și solicitați configurarea terminalului PAX A930 pentru a funcționa anume prin protocolul JSON (TCP/COM) prin Wi-Fi.
•
Rețea: rezervați neapărat adresa IP a terminalului în setările routerului, astfel încât aceasta să nu se schimbe după reporniri.
•
În Torgsoft: în setările terminalului bancar din Torgsoft este suficient să selectați protocolul JSON (COM/TCP) și să indicați adresa IP și portul.
•
Avantaje: această metodă funcționează mai stabil, permite programului să păstreze un jurnal detaliat al operațiunilor terminalului și reduce semnificativ riscul de erori și de pierdere a conexiunii.
Metoda 2: Când se utilizează WebSocket prin «Integrare casă»
Această metodă este încă folosită, însă suportul tehnic o consideră învechită și mai puțin stabilă, deoarece necesită un server WebSocket care rulează pe PC.
•
Pe ecranul principal Android al terminalului deschideți aplicația «Integrare casă».
•
Selectați tipul: «CONEXIUNE WIFI».
•
Verificați starea: pe ecran trebuie să clipească indicatorul verde de conexiune.
•
Critic de important (riscuri): terminalul trebuie să rămână mereu cu această aplicație deschisă în acest mod. Dacă operatorul iese în meniul principal Android, minimizează accidental aplicația sau pe terminal pornește orice altă operațiune în fundal, încercarea de a transmite suma din Torgsoft va duce la eroarea «Dispozitiv ocupat» (DeviceBusy), iar programul va aștepta mult timp un răspuns.
Sfat suplimentar. Dacă în prezent vă confruntați cu blocări constante sau erori precum «DeviceBusy», specialiștii de la suportul tehnic Torgsoft recomandă insistent să reconfigurați terminalul PAX A930 de la vechiul protocol JSON (WebSocket) la JSON direct (COM/TCP).
3. Cum se configurează terminalul în Torgsoft
Meniu: Setări → Parametri → Funcții suplimentare → Terminal bancar.
În continuare, setările depind de tipul de conexiune configurat de bancă pentru dvs.:
Metoda 1: Setări pentru conexiune directă JSON (TCP/COM) — Recomandat
Această metodă este utilizată atunci când terminalul comunică direct cu Torgsoft prin rețea.
•
Tip protocol: selectați JSON (COM/TCP).
•
Adresă IP: introduceți adresa IP statică a terminalului bancar propriu-zis, pe care ați rezervat-o anterior pentru el în setările routerului.
•
Port: de regulă se utilizează portul 2000 (sau 2001, 2100 etc. — portul exact trebuie furnizat de suportul tehnic al băncii în timpul configurării).
•
Merchant: lăsați gol sau indicați 0. În cazul terminalului PAX A930, alegerea comerciantului (dacă aveți mai multe conturi merchant) are loc adesea direct pe ecranul terminalului în timpul plății.
Metoda 2: Setări prin WebSocket/JSON (metodă învechită)
Această metodă este utilizată dacă pentru comunicarea cu terminalul trebuie să ruleze obligatoriu pe calculatorul operatorului un program de fundal furnizat de bancă (server WebSocket, de exemplu genericDriverJson sau POSsvc.exe).
•
Tip protocol: selectați WebSocket/JSON.
•
Adresă IP host: aici se introduce adresa IP a calculatorului pe care rulează serverul WebSocket (dacă programul-driver rulează pe același calculator ca Torgsoft, se introduce adresa locală, de exemplu localhost sau 127.0.0.1).
•
Port: întotdeauna 3000 (acesta este portul standard pentru serviciul WebSocket).
•
Merchant: lăsați gol sau indicați 0.
Este critic de important să nu confundați adresele IP: la conectarea directă (Metoda 1) se indică IP-ul terminalului, iar la lucrul prin WebSocket (Metoda 2) — IP-ul calculatorului pe care rulează driverul.
4. Ce timeout trebuie setat
•
Setați parametrul «Timeout răspuns»: minimum 180 de secunde.
•
De ce: Torgsoft primește semnalul de succes numai după imprimarea bonului pe terminal. Dacă timeout-ul este prea mic (60 s), programul va întrerupe conexiunea și va anula bonul din baza de date, deși banii clientului au fost deja retrași.
5. Ce trebuie luat în considerare la returnarea produselor
•
Activați opțiunea: «Utilizați serviciul».
•
Pentru returnare este necesar codul RRN (codul de autorizare) de pe bonul de vânzare tipărit.
•
Acest cod este introdus manual de operator pe tastatura terminalului atunci când dispozitivul îl solicită.
Cum să verificați că terminalul funcționează corect
1.
Asigurați-vă că pe terminal este activ indicatorul verde.
2.
Efectuați o vânzare de test în valoare de 1,00 UAH.
3.
Terminalul trebuie să activeze cititorul de carduri.
4.
După plată, bonul din Torgsoft trebuie să se închidă automat.
Cum să evitați defecțiunile în funcționarea PAX A930
•
Nu permiteți personalului să se joace sau să stea pe YouTube pe terminal (este un dispozitiv Android, dar trebuie să rămână în modul de casă).
•
Monitorizați nivelul bateriei: sub 15%, modulul Wi-Fi poate funcționa instabil.
Ce este important să rețineți
Dacă terminalul nu răspunde — verificați mai întâi dacă aplicația «Integrare casă» este pornită și dacă adresa IP nu s-a schimbat.
Reveniți la pasul anterior