O tranzacție de vânzare este o operațiune de plată de bază care prevede transferul unei sume specificate din contul bancar al titularului cardului în contul comerciantului.
În ceea ce privește procesul de plată, procedura este după cum urmează:
Autentificare & Autentificare
Autentificarea simbolului JWT este necesară pentru toate punctele finale non-publice. Obțineți simbolul (cu o durată de viață de 90 de zile) prin punctul final /cloud/oauth/token cu următoarele argumente furnizate:
- Autentificarea de bază pentru punctele finale ale tokenului (nume/parolă) - va fi furnizată pentru fiecare utilizator.
- Numele de utilizator al comerciantului – la fel ca pentru GP tom
- Parola comerciantului – la fel ca pentru GP tom
- ID terminal (TID) – ID terminal de destinație
- Punctul final al autorizării se află la adresa:
Această metodă de autentificare este aceeași pentru toate terminalele.
Obțineți un simbol de acces
Exemplu de solicitare:
POST {{apiCloudHost}}/cloud/oauth/token
Authorization: Basic YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded
(Authorization a Contect-Type je pro všechny zákazníky vždy stejný – použijte prosím stejné údaje jako v příkladu. Do grant_type je potřeba následně vložit unikátní údaje klienta).
grant_type=password&username=jan.novak@example.com&password=ABCDEFGHIJKL&tid=999888
Exemplu de răspuns:
{ "access_token": "eyJh…", // access token used in authenticated API requests "token_type": "bearer", "refresh_token": "GciO…", "expires_in": 3600, "scope": "read write", "tid": "999888", }
Reînnoirea tokenului
Când expiră access_tokenu, refresh_token este disponibilă.
Exemplu de solicitare:
POST {{apiHost}}/api/oauth/token
Authorization: Basic YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded
grant_type=refresh_token&refresh_token=GciO…
GPTomAuth
Crearea unei activități
Apelați punctul final POST /v1/tasks/TRANSACTION și utilizați CreateCloudTaskTransactionApiRequest cu următoarele informații completate pentru a face solicitarea:
OBLIGATORIU
OBLIGATORIU
OBLIGATORIU
OBLIGATORIU
Exemplu: "Factură 37364FD"
Adevărat dacă chitanța urmează să fie imprimată pe dispozitiv.
Notă: Pentru telefoanele mobile, trebuie să vă asigurați că imprimanta Bluetooth este conectată.
OBLIGATORIU
OBLIGATORIU
Valori posibile: [ LAST_TRANSACTION, OLDER_TRANSACTION ]
OBLIGATORIU
Dacă este setat la true, ecranul de introducere a bacșișului din GP tom va fi apelat primul.
Pentru a apela acest ecran, trebuie ca în aplicație să fie activat bacșișul.
Conținutul răspunsului [CloudTaskDetailApiResponse]:
Codurile de răspuns posibile sunt:
Mai jos veți găsi variabilele utilizate în răspuns:
Verificarea stării unei activități
V dalším kroku budete kontrolovat stav tasku na koncovém bodu GET /v1/tasks/{taskID} pomocí požadavku, který zahrnuje:
Coduri de returnare posibile:
Variabile în răspuns:
Solicitarea de stare a activității trebuie repetată până când obțineți unul dintre codurile de răspuns finale, care sunt:
Puteți trece la pasul următor numai atunci când răspunsul este în starea finalizată.
Obținerea unui rezultat de plată
Nyní víme, že transakce byla autorizována. Cílem tohoto kroku je získat stav transakce a detaily transakce. Pro nový požadavek zavoláte koncový bod GET /v1/transactions/{transactionId}, kde použijete následující proměnné:
Codurile de răspuns posibile sunt:
Răspunsul conține următoarele variabile, în funcție de codul de răspuns:
ACCEPTED - tranzacția a fost autorizată cu succes
DECLINED - tranzacția a fost respinsă din anumite motive
CANCELLED - în cazul în care tranzacția este anulată de către operator sau client
Tipul operațiunii/tranzacției."
Dacă aveți de gând să generați sau să imprimați chitanța de partea dvs., vă recomandăm să verificați ce câmpuri sunt necesare și trebuie să fie imprimate / afișate pe chitanță. Descrierea este disponibilă aici.