Informácia
Ak cez Cloud API keď zavoláte na zrušenie platby, je potrebné vytvoriť úlohu pre zariadenie (TID), kde bola platba pôvodne vykonaná. Volanie na zrušenie platby uskutočnenej na termináli "A" na termináli "B" nie je v súčasnosti podporované.
Vrátenie transakcie je základná platobná operácia, ktorá vám umožňuje zrušiť predtým spracovanú transakciu do 93 dní po pôvodnej transakcii. Zrušenie transakcie je možné vykonať bez zákazníckej karty – prostriedky budú automaticky vrátené na kartu použitú na pôvodnú transakciu typu predaja.
Prihlásenie & autentifikácia
Overenie tokenom JWT sa vyžaduje pre všetky neverejné koncové body. Token (so životnosťou 90 dní) získate prostredníctvom koncového bodu /cloud/oauth/token s nasledujúcimi argumentmi:
- Základná autentifikácia pre koncové body tokenov (meno/heslo) - bude zabezpečená pre každého používateľa.
- Používateľské meno obchodníka – rovnaké ako pre GP tom
- Heslo obchodníka – rovnaké ako pre GP tom
- ID terminálu (TID) – ID cieľového terminálu
- Autorizačný koncový bod sa nachádza na adrese:
Získanie prístupového tokenu
Príklad žiadosti:
POST {{apiCloudHost}}/cloud/oauth/token
Authorization: Basic YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded
grant_type=password&username=jan.novak@example.com&password=ABCDEFGHIJKL&tid=999888
Príklad odpovede:
{ "access_token": "eyJh…", // access token used in authenticated API requests "token_type": "bearer", "refresh_token": "GciO…", "expires_in": 3600, "scope": "read write", "tid": "999888", }
Obnovenie tokenu
Po uplynutí platnosti access_tokenu je k dispozícii refresh_token.
Príklad žiadosti:
POST {{apiHost}}/api/oauth/token
Authorization: Basic YXRvbTphc2hmdWY0ZTVmYQ==
Content-Type: application/x-www-form-urlencoded
grant_type=refresh_token&refresh_token=GciO…
GPTomAuth
Vytvorenie úlohy
Zavolajte na koncový bod POST /v1/úlohy/TRANSACTION a na podanie žiadosti použite CreateCloudTaskTransactionApiRequest s vyplnenými nasledujúcimi informáciami:
MANDATORY
POVINNÝ
POVINNÝ
POVINNÝ
POVINNÝ
POVINNÝ
POVINNÝ
Príklad: "Platba faktúry 37364FD"
Platí, ak sa má účtenka vytlačiť na zariadení.
Poznámka: V prípade mobilných telefónov skontrolujte, či je pripojená tlačiareň Bluetooth.
LAST_TRANSACTION - používa sa iba na predtým autorizovanú transakciu. Medzi touto úlohou a predchádzajúcou predajnou úlohou nemôže byť žiadna iná požiadavka.
OLDER_TRANSACTION – Používa sa pre všetky staršie transakcie okrem poslednej transakcie.
Obsah odpovede [CloudTaskDetailApiResponse]:
Možné kódy odpovedí sú:
Nižšie nájdete premenné použité v odpovedi:
Kontrola stavu úlohy
V dalším kroku budete kontrolovat stav tasku na koncovém bodu GET /v1/tasks/{taskID} pomocí požadavku, který zahrnuje:
Možné návratové kódy:
Premenné v odpovedi:
Žiadosť o stav úlohy by sa mala opakovať, kým nedostanete jeden z kódov konečnej odpovede, ktoré sú:
K ďalšiemu kroku môžete pristúpiť len vtedy, keď je odpoveď v stave DOKONČENÉ.
Získanie výsledku platby
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é:
Možné kódy odpovedí sú:
Odpoveď obsahuje nasledujúce premenné v závislosti od kódu odpovede:
ACCEPTED - transakcia bola úspešne autorizovaná
DECLINED - transakcia bola z nejakého dôvodu zamietnutá
CANCELLED - ak je transakcia zrušená prevádzkovateľom alebo zákazníkom
Typ operácie/transakcie."
Ak sa chystáte vygenerovať alebo vytlačiť účtenku na svojej strane, odporúčame vám skontrolovať, ktoré polia sú povinné a musia byť vytlačené/zobrazené na účtenke. Popis je k dispozícii tu.