Storno transakcia je jednou zo základných platobných operácií, ktorá zabezpečuje zrušenie už vykonanej platobnej transakcie späť na účet držiteľa karty.
Postup zrušenia je nasledovný:
Vytvorenie zrušenia
Transakciu možno iniciovať volaním:
gptom://transaction/cancel?…
kde sa na zostavenie správy použijú nasledujúce parametre vrátane amsID, ktoré je priradené každej platbe:
Premenná/polie
Formát/Format
Popis/popis
Príklad
id klienta
string
amsID MANDATORY
string
CZ: Jedinečné amsID, ktoré dostanete v čase platby.
SK: Jedinečné amsID, ktoré dostanete pri platbe.
SK: Jedinečné amsID, ktoré dostanete pri platbe.
redirectUrl
string
CZ: Adresa URL vašej aplikácie, na ktorú klienta presmerujeme po dokončení zrušenia.
SK: Adresa URL vašej aplikácie, na ktorú klienta presmerujeme po dokončení zrušenia.
SK: Adresa URL vašej aplikácie, na ktorú klienta presmerujeme po dokončení zrušenia.
fb://Success
preferableReceiptType
enum (sms,email,qr,print)
GP tom API CZ: V prípade odosielania potvrdenia z aplikácie je možné preddefinovať spôsob odoslania potvrdenia prostredníctvom .
GP tom API
Možné hodnoty sú: SK: V prípade odoslania potvrdenia z aplikácie je možné preddefinovať spôsob odoslania potvrdenia prostredníctvom . Možné hodnoty sú: TELEFÓN EMAIL QR TLAČ
GP tom API
Možné hodnoty sú: SK: V prípade odoslania potvrdenia z aplikácie je možné preddefinovať spôsob odoslania potvrdenia prostredníctvom . Možné hodnoty sú: TELEFÓN EMAIL QR TLAČ
text
printByPaymentApp
bool
GP tom GP tom SK: Určuje, či účtenku klientovi odovzdá vaša aplikácia alebo . Predvolená hodnota je true (t. j. ponúkne metódu odovzdania účtenky klientovi). Ak pošlete hodnotu "false", vrátime používateľa vašej aplikácii ihneď po transakcii a je na vás, aby ste účtenku odovzdali.
GP tom SK: Určuje, či účtenku klientovi odovzdá vaša aplikácia alebo . Predvolená hodnota je true (t. j. GP ponúkne spôsob odovzdania účtenky klientovi). Ak pošlete hodnotu "false", používateľa okamžite po transakcii vrátime vašej aplikácii a odovzdanie účtenky je na vás.
GP tom SK: Určuje, či účtenku klientovi odovzdá vaša aplikácia alebo . Predvolená hodnota je true (t. j. GP ponúkne spôsob odovzdania účtenky klientovi). Ak pošlete hodnotu "false", používateľa okamžite po transakcii vrátime vašej aplikácii a odovzdanie účtenky je na vás.
true/false
klientTelefón
string
CZ: Telefónne číslo klienta.
SK: Telefónne číslo klienta.
SK: Telefónne číslo klienta.
+420606505404
clientEmail
string
CZ: E-mailová adresa klienta.
SK: E-mailová adresa klienta.
SK: 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ť tieto polia:
Pole/Pole
Popis/popis
Príklad/vzor
STAV ÚLOHY
CZ: Uvádza odpoveď, v akom stave sa žiadosť skončila.
SK: Poskytuje informáciu, v akom stave sa žiadosť skončila.
SK: Poskytuje informáciu, v akom stave sa žiadosť skončila.
DOKONČENÁ ZRUŠENÁ CHYBA
id terminálu
CZ: ID terminálu, na ktorom sa transakcie spracúvajú.
Identifikuje terminál v systémoch GP. SK: Jedinečné ID terminálu, na ktorom sa transakcia spracúva.
Identifikuje terminál v systémoch GP. SK: Jedinečné ID terminálu, na ktorom sa transakcia spracúva.
12345678
amount
CZ: 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 transakcie kartou, pripísané mínus odpísané.
SK: Suma určuje objem transakcie. Táto suma sa počíta v domácej mene používanej terminálom. V deň uzávierky obsahuje všetky transakcie kartou, pripísané mínus odpísané.
SK: Suma určuje objem transakcie. Táto suma sa počíta v domácej mene používanej terminálom. V deň uzávierky obsahuje všetky transakcie kartou, pripísané mínus odpísané.
10
batchNumber
CZ: Identifikuje číslo uzávierky. Vyplní sa, ak sa požaduje uzávierka.
SK: Určuje číslo dávky. Uvádza sa počas transakcie uzávierky dávky.
SK: Určuje číslo dávky. Uvádza sa počas transakcie uzávierky dávky.
1
emvAppLabel
CZ: Názov EMV, ktorý bol použitý pri platbe.
SK: Štítok použitej karty
SK: Štítok použitej karty
Debetná karta Visa
amsID
CZ: Jedinečné číslo transakcie.
SK: Jedinečné číslo transakcie.
SK: Jedinečné číslo transakcie.
referenceNumber
CZ: Referenčné číslo zadané pri žiadosti o platbu.
SK: Referenčné číslo zadané pri žiadosti o platbu
SK: Referenčné číslo zadané pri žiadosti o platbu
ABC123
sequenceNumber
CZ: Používa sa na storno transakcie. Použite prijatú hodnotu, ktorá bola súčasťou transakcie, ktorú chcete zrušiť.
SK: Používa sa na zrušenie transakcie. Použije sa prijatá hodnota, ktorá bola súčasťou transakcie, ktorú chcete zrušiť.
SK: Používa sa na zrušenie transakcie. Použije sa prijatá hodnota, ktorá bola súčasťou transakcie, ktorú chcete zrušiť.
001000000
transactionType
SK: Definuje typ transakcie.
SK: Definuje typ transakcie.
SK: Definuje typ transakcie.
KARTA
date
CZ: Označuje čas transakcie.
SK: Uveďte dátum transakcie.
SK: Uveďte dátum transakcie.
2024-10-29T12:14:00.112Z
currencyCode
CZ: Trojmiestne kódy mien ISO - ich zoznam nájdete na stránke Wiki.
SK: Trojmiestny kód meny ISO.
SK: Trojmiestny kód meny ISO.
EUR
merchantID
CZ: Jedinečné ID obchodníka, zvyčajne ID lokality. SK: Jedinečné ID obchodníka, zvyčajne ID lokality.
tipAmount
CZ: Tipy. Vyplní sa, ak bol zadaný.
SK: Tip. Vyplní sa, ak je to potrebné.
SK: Tip. Vyplní sa, ak je to potrebné.
2
totalAmount
CZ: Označuje celkovú sumu transakcie (vrátane prepitného). SK: Označuje celkovú sumu transakcie (vrátane prepitného).
12
result
CZ: Odpoveď na žiadosť.
SK: Výsledok žiadosti.
SK: Výsledok žiadosti.
0 = dokončené -1 = odmietnuté
cardEntryMode
CZ: Identifikuje spôsob, akým boli údaje na karte zadané, napríklad čip, bezkontaktný čip, magstripe atď. SK: Definuje spôsob čítania karty: magstripe, čip alebo bezkontaktný čip.
BEZKONTAKTNÉ
identifikátor transakcie
CZ: Jedinečný identifikátor vygenerovaný platobnou aplikáciou počas procesu registrácie transakcie.
SK: Jedinečné ID vygenerované platobnou aplikáciou počas procesu registrácie transakcie.
SK: Jedinečné ID vygenerované platobnou aplikáciou počas procesu registrácie transakcie.
001000000
authorizationCode
CZ: Vyplní sa len v prípade, že sa transakcia nakoniec schváli.
SK: Uvádza sa len v prípade, ak je transakcia spracovaná.
SK: Uvádza sa len v prípade, ak je transakcia spracovaná.
123456
cardNumber
CZ: Číslo karty (PAN). Uvádza sa v maskovanej podobe.
SK: Číslo karty (PAN). Je uvedené v maskovanej podobe.
SK: Číslo karty (PAN). Je uvedené v maskovanej podobe.
0001
pinOk
true/false
KÓD
CZ: Zobrazí výsledok transakcie pri autorizácii.
SK: Zobrazí výsledok transakcie na strane autorizácie.
SK: Zobrazí výsledok transakcie na strane autorizácie.
schválené