Anularea unei tranzacții este o operațiune de plată de bază care permite anularea unei tranzacții procesate anterior, în termen de până la 93 de zile de la data tranzacției inițiale. Anularea tranzacției se poate efectua fără cardul clientului – fondurile vor fi rambursate automat pe cardul utilizat pentru tranzacția inițială de tip vânzare.

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:
  • Dev: https://cloud-api-dev.gptom.com/cloud/oauth/token
  • producție: https://cloud-api.gptom.com/cloud/oauth/token

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/TRANSACTION și utilizați CreateCloudTaskTransactionApiRequest cu următoarele informații completate pentru a crea cererea:

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 plății

Acum știm că tranzacția a fost autorizată. Scopul acestei etape este de a obține starea și detaliile tranzacției. Pentru noua cerere, veți apela endpoint-ul GET /v1/transactions/{transactionId} 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:

Pokud budete účtenku generovat nebo tisknout na své straně, doporučujeme zkontrolovat, která pole jsou povinná a musí být vytištěna/zobrazena na účtence. Popis je k dispozici zde.