Storno transakcie patrí medzi základné platobné operácie, ktoré zabezpečujú vrátenie už vykonanej platobnej transakcie späť na účet držiteľa karty.
Postup zrušenia je nasledovný:
Vytvorenie storna
Transakciu je možné iniciovať volaním:
gptom://transaction/cancel?…
kde sa na zostavenie správy používajú nasledujúce parametre vrátane amsID, ktoré je pridelené ku každej platbe:
Premenná/Pole
Formát
Popis
Príklad
ID klienta
reťazec
amsID
POVINNÉ
POVINNÉ
reťazec
SK: Jedinečné amsID, ktoré dostanete pri platbe.
EN: Jedinečné číslo amsID, ktoré dostanete po zaplatení.
EN: Jedinečné číslo amsID, ktoré dostanete po zaplatení.
redirectUrl
reťazec
SK: URL vašej aplikácie, na ktorú presmerujeme klienta po dokončení zrušenia.
EN: URL vašej aplikácie, na ktorú presmerujeme klienta po dokončení zrušenia.
EN: URL vašej aplikácie, na ktorú presmerujeme klienta po dokončení zrušenia.
fb://Success
preferovaný typ potvrdenia
enum (sms, e-mail, qr, tlač)
SK: Pri odosielaní účtenky z aplikácie GP je možné prostredníctvom API vopred definovať spôsob odoslania účtenky. Možné hodnoty sú:
EN: V prípade zasielania potvrdenia z aplikácie GP je možné vopred nastaviť spôsob zasielania potvrdenia prostredníctvom API. Možné hodnoty sú:
TELEFÓN
E-MAIL
QR
TLAČ
EN: V prípade zasielania potvrdenia z aplikácie GP je možné vopred nastaviť spôsob zasielania potvrdenia prostredníctvom API. Možné hodnoty sú:
TELEFÓN
QR
TLAČ
SMS
tlač cez platobnú aplikáciu
bool
SK: Určuje, či účtenku klientovi odovzdá vaša aplikácia alebo GP tom. Predvolená hodnota je true (t. j. GP tom ponúkne spôsob odovzdania účtenky klientovi). Ak zadáte hodnotu “false”, ihneď po transakcii vrátime používateľa do vašej aplikácie a odovzdanie účtenky je na vás.
EN: Určuje, či potvrdenku odovzdá klientovi vaša aplikácia alebo GP. Predvolená hodnota je true (t. j. GP ponúkne spôsob, ako potvrdenku odovzdať klientovi). Ak zadáte hodnotu "false", používateľa vrátime do vašej aplikácie ihneď po transakcii a odovzdanie potvrdenia je na vás.
EN: Určuje, či potvrdenku odovzdá klientovi vaša aplikácia alebo GP. Predvolená hodnota je true (t. j. GP ponúkne spôsob, ako potvrdenku odovzdať klientovi). Ak zadáte hodnotu "false", používateľa vrátime do vašej aplikácie ihneď po transakcii a odovzdanie potvrdenia je na vás.
pravda/nepravda
telefón klienta
reťazec
SK: Telefónne číslo klienta.
EN: Telefónne číslo klienta.
EN: Telefónne číslo klienta.
+420606505404
e-mail klienta
reťazec
SK: E-mailová adresa klienta.
EN: E-mailová adresa klienta.
EN: E-mailová adresa klienta.
info@gptom.com
Príklad volania:
gptom://transaction/cancel?amsID=123&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/cancel&clientEmail=info@gptom.com
Odpoveď bude obsahovať nasledujúce polia:
Pole/Pole
Popis
Príklad
STATUS ÚLOHY
SK: Uvádza, v akom stave daná požiadavka skončila.
EN: Poskytuje informácie o tom, v akom stave sa vaša žiadosť nachádza.
EN: Poskytuje informácie o tom, v akom stave sa vaša žiadosť nachádza.
DOKONČENÉ
ZRUŠENÉ
CHYBA
ZRUŠENÉ
CHYBA
ID terminálu
SK: ID terminálu, na ktorom sa transakcie spracúvajú. Identifikuje terminál v systémoch GP.
EN: Jedinečné identifikačné číslo terminálu, na ktorom sa transakcia spracováva.
EN: Jedinečné identifikačné číslo terminálu, na ktorom sa transakcia spracováva.
12345678
suma
SK: Suma určuje objem transakcie. Táto suma sa počíta v domácej mene, ktorú používa terminál. Pri uzávierke zahŕňa všetky kartové transakcie, a to pripísané mínus debetné.
EN: Táto suma určuje objem transakcie. Vypočíta sa v domácej mene, ktorú používa terminál. Na konci dňa zahŕňa všetky transakcie kartou, pričom sa odpočítavajú debetné transakcie od kreditných.
EN: Táto suma určuje objem transakcie. Vypočíta sa v domácej mene, ktorú používa terminál. Na konci dňa zahŕňa všetky transakcie kartou, pričom sa odpočítavajú debetné transakcie od kreditných.
10
číslo šarže
SK: Identifikuje číslo uzávierky. Vyplňuje sa v prípade požiadavky na uzávierku.
EN: Určuje číslo šarže. Zadáva sa pri transakcii uzavretia šarže.
EN: Určuje číslo šarže. Zadáva sa pri transakcii uzavretia šarže.
1
emvAppLabel
SK: Názov karty EMV, ktorá bola použitá pri platbe.
EN: Štítok použitej karty
EN: Štítok použitej karty
Debetná karta Visa
amsID
SK: Jedinečné číslo transakcie.
EN: Jedinečné číslo transakcie.
EN: Jedinečné číslo transakcie.
referenčné číslo
SK: Referenčné číslo uvedené v žiadosti o platbu.
EN: Referenčné číslo zadané pri platbe
EN: Referenčné číslo zadané pri platbe
ABC123
číslo sekvencie
SK: Používa sa na zrušenie transakcie. Použite hodnotu, ktorú ste dostali a ktorá bola súčasťou transakcie, ktorú chcete zrušiť.
EN: Slúži na zrušenie transakcie. Použite prijatú sumu, ktorá bola súčasťou transakcie, ktorú chcete zrušiť.
EN: Slúži na zrušenie transakcie. Použite prijatú sumu, ktorá bola súčasťou transakcie, ktorú chcete zrušiť.
001000000
typ transakcie
SK: Definuje typ transakcie.
EN: Určuje typ transakcie.
EN: Určuje typ transakcie.
KARTA
dátum
SK: Uvádza čas transakcie.
EN: Uveďte dátum transakcie.
EN: Uveďte dátum transakcie.
2024-10-29T12:14:00.112Z
kód meny
SK: Trojmiestne kódy mien ISO – zoznam nájdete na stránke Wiki.
EN: Trojznakový kód meny podľa ISO.
EN: Trojznakový kód meny podľa ISO.
EUR
merchantID
SK: Jedinečné ID obchodníka, zvyčajne ide o ID lokality.
EN: Jedinečné identifikačné číslo obchodníka, zvyčajne identifikačné číslo lokality
EN: Jedinečné identifikačné číslo obchodníka, zvyčajne identifikačné číslo lokality
tipAmount
SK: Spropitné. Vyplní sa v prípade, ak bolo zadané.
EN: Tip. Vyplňte v prípade potreby.
EN: Tip. Vyplňte v prípade potreby.
2
celková suma
SK: Uvádza celkovú sumu transakcie (vrátane prepitného).
EN: Uvádza celkovú sumu transakcie (vrátane prepitného)
EN: Uvádza celkovú sumu transakcie (vrátane prepitného)
12
výsledok
SK: Odpoveď na žiadosť.
EN: Výsledok požiadavky.
EN: Výsledok požiadavky.
0 = dokončené
-1 = odmietnuté
-1 = odmietnuté
režim zadávania karty
SK: Určuje spôsob zadávania údajov o karte, napríklad čip, bezkontaktná technológia, magnetický prúžok atď.
EN: Určuje, akým spôsobom bola karta prečítaná: magnetický prúžok, čip alebo bezkontaktne.
EN: Určuje, akým spôsobom bola karta prečítaná: magnetický prúžok, čip alebo bezkontaktne.
BEZKONTAKTNÉ
transactionID
SK: Jedinečné identifikačné číslo vygenerované platobnou aplikáciou počas procesu registrácie transakcie.
EN: Jedinečné identifikačné číslo vygenerované platobnou aplikáciou počas procesu registrácie transakcie.
EN: Jedinečné identifikačné číslo vygenerované platobnou aplikáciou počas procesu registrácie transakcie.
001000000
autorizačný kód
SK: Vyplňuje sa len v prípade, ak transakcia skončí ako schválená.
EN: Je prítomný práve vtedy, ak je transakcia spracovaná.
EN: Je prítomný práve vtedy, ak je transakcia spracovaná.
123456
číslo karty
SK: Číslo karty (PAN). Je uvedené v zakódovanej podobe.
EN: Číslo karty (PAN). Je uvedené v maskovanej podobe.
EN: Číslo karty (PAN). Je uvedené v maskovanej podobe.
0001
pinOk
pravda/nepravda
KÓD
SK: Zobrazuje výsledok transakcie pri autorizácii.
EN: Zobrazuje výsledok transakcie na strane autorizácie.
EN: Zobrazuje výsledok transakcie na strane autorizácie.
schválené