Ce este mai exact o doză? Fiecare tranzacție pe care o creați aparține unui lot. La fel ca o chitanță, fiecare lot are un număr și este de fapt un pachet de tranzacții. O închidere este o operațiune administrativă prin care terminalul închide un lot și solicită sistemelor să închidă lotul și să deschidă unul nou. În sistemele Global Payments, este posibil să se vadă numărul de închidere pentru fiecare tranzacție și este posibil să se filtreze tranzacțiile în funcție de acest număr.
Conectare și autentificare
Autentificarea cu jetonul JWT este necesară pentru toate punctele finale nepublice. Jetonul (cu o durată de viață de 90 de zile) este obținut prin intermediul punctului final /cloud/oauth/token, cu următoarele argumente furnizate:
- Autentificarea de bază pentru punctele finale cu token (nume/parolă) - va fi furnizată pentru fiecare utilizator.
- Numele de utilizator Trader - același ca pentru GP tom
- Parola Trader - aceeași ca pentru GP tom
- ID terminal (TID) - ID al terminalului de destinație
- Punctul final de autorizare este situat la:
Obținerea unui jeton de acces
Exemplu de cerere:
POST {{apiCloudHost}}/cloud/oauth/token
Autorizare: Basic YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded
grant_type=password&username=jan.novak@example.com&password=ABCDEFGHIJKL&tid=999888
Exemplu de răspuns:
{
"access_token": "eyJh...", // token de acces utilizat în cererile API autentificate
"token_type": "bearer",
"refresh_token": "GciO...",
"expires_in": 3600,
"scope": "read write",
"tid": "999888",
}Reînnoirea unui jeton
Atunci când access_token expiră, este disponibil un refresh_token.
Exemplu de cerere:
POST {{apiHost}}/api/oauth/token
Autorizare: Basic YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded
grant_type=refresh_token&refresh_token=GciO...
GPTomAuth
Crearea unui sac
Apelați la punctul final POST /v1/tasks/BATCH și utilizați CreateCloudTaskTransactionApiRequest cu următoarele informații completate pentru a crea cererea:
OBLIGATORIU
OBLIGATORIU
OBLIGATORIU
OBLIGATORIU
OBLIGATORIU
Exemplu: „Factura 37364FD“
Conținutul [CloudTaskDetailApiResponse]:
Codurile de răspuns posibile sunt:
Mai jos sunt prezentate variabilele utilizate în răspuns:
Verificați starea sacului
În etapa următoare, veți verifica starea sarcinii la punctul final GET /v1/tasks/{taskID} utilizând o cerere care include:
Coduri de retur posibile:
Variabile de răspuns:
Solicitarea privind starea sacului trebuie repetată până când obțineți unul dintre codurile finale de răspuns, care sunt:
Puteți trece la pasul următor numai dacă răspunsul este în starea COMPLETAT.
Obținerea rezultatului final
Acum știm că închiderea a fost autorizată. Scopul acestei etape este de a obține starea termenului și datele sale. Pentru noua cerere, apelați endpoint-ul GET /v1/batches/{batchId} utilizând următoarele variabile:
Codurile de răspuns posibile sunt:
Răspunsul conține următoarele variabile, în funcție de codul de răspuns:
-closeBatchNumber (string) - closeBatchNumber podřízené dávky
- totalCount (number) - Celkový počet transakcí v dávce
- saleCount (number) - Počet transakcí typu prodej v dávce
- saleAmount (number) - Objem transakcí typu prodej v dávce
- voidCount (number) - Počet storen transakcí
- voidAmount (number) - Objem storen transakcí v dávce