Linkit Răspunsuri pe scurt
Cum trimite un program de vânzare suma către Linkit?
În două feluri: scrie un fișier cu o singură linie, POS^<suma în bani>, într-un dosar, sau apelează un API local pe 127.0.0.1. În ambele cazuri primește același răspuns, cu trei stări: încasat, neîncasat sau neclar.
1. Prin fișier
Pentru programe care scriu deja fișiere de comandă. Nu e nimic de instalat în program și nu e nevoie de parolă sau de token.
POS^1000 10,00 lei pe singurul terminal activ
POS^1000^t2 10,00 lei pe terminalul „t2”- Fișierul se scrie în dosarul de comenzi, implicit
%LOCALAPPDATA%\Linkit\Bonuri. Suma este în bani, număr întreg, fără zecimale. - Scrie-l sigur: întâi
nume.tmp, apoi redenumește-l înnume.txt. Folosește un nume nou la fiecare plată, de exemplu numărul bonului. - Răspunsul apare în dosarul
Raspuns, sub același nume. Citește întâi liniaBONOK.
| Răspuns | Înseamnă | Ce face programul |
|---|---|---|
BONOK=1 | Aprobat: banii au fost luați | Închide bonul cu plata cu cardul |
BONOK=0 | Sigur neîncasat: refuzat, anulat sau netrimis | Arată mesajul; altă încercare = o comandă nouă |
BONOK=-1 | Neclar: suma s-ar putea să fi fost luată | Nu plătește din nou; casierul verifică terminalul |
Același fișier pus a doua oară primește același răspuns și nu este încasat de două ori.
2. Prin API local
Pentru integrări noi. Linkit ascultă doar pe 127.0.0.1, pe calculatorul de la casă; portul și tokenul se citesc din două fișiere din dosarul de date Linkit al utilizatorului Windows. Corpurile sunt JSON, cu sume în bani, numere întregi.
POST /api/v1/pos/payments
{"request_id":"bon-000147-1","terminal":"t1","amount_bani":14750,"currency":"RON"}request_ideste un identificator nou pentru fiecare încercare de plată. Programul îl salvează înainte de apel.- Același
request_idtrimis din nou întoarce aceeași plată; nu încasează a doua oară. - După orice eroare sau timeout, programul întreabă starea cu
GET /api/v1/pos/payments/{request_id}; nu trimite o plată nouă. - În răspuns,
chargedestetrue(încasat),false(neîncasat) sau"unknown"(neclar: nu reîncerca și nu elibera marfa).
3. Programe care trimit deja o linie POS^ prin HTTP local
Există și un set mic de rute de compatibilitate pentru astfel de programe. Este oprit implicit și se pornește doar la nevoie, din setări.
Documentația completă
Rutele, schemele JSON și exemplele (PowerShell, Python, HTTP simplu), plus un terminal de probă care nu mișcă bani, le trimitem la cerere. Cere documentația pentru integratori.
Linkit este un program mic pentru Windows care leagă programul de vânzare al magazinului de terminalul de card (POS-ul bancar). Nu este lansat încă; proba gratuită de 14 zile apare în curând.