Co přesně je dávka? Každá transakce, kterou vytvoříte, patří do tzv. dávky. Stejně jako účtenka má každá dávka své číslo a je vlastně balíčkem transakcí. Uzávěrka je administrativní operace, pomocí které terminál uzavře dávku a vyzve systémy, aby se dávka uzavřela a otevřela nová. V systémech Global Payments je možné u každé transakce vidět číslo uzávěrky a je možné transakce filtrovat podle tohoto čísla.
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
Zavolejte koncový bod POST /v1/tasks/BATCH a použijte CreateCloudTaskTransactionApiRequest s následujícími údaji vyplněnými k vytvoření požadavku:
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.
Získání výsledku uzávěrky
Nyní víme, že uzávěrka byla autorizována. Cílem tohoto kroku je získat stav uzávěrky a její údaje. Pro nový požadavek zavoláte koncový bod GET /v1/batches/{batchId}, 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:
-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