Transakcia „vrátenie“ umožňuje vrátiť peniaze na ľubovoľnú kartu zákazníka bez nutnosti vyhľadávania predchádzajúcej predajnej transakcie.
Postup návratu je nasledovný:
Vytvorenie návratu
Transakciu je možné iniciovať volaním:
gptom://transaction/refund?…
kde sa na zostavenie správy používajú nasledujúce parametre vrátane amsID, ktoré je pridelené každej platbe:
Premenná/Pole
Formát
Popis
Príklad
suma
dlhý
CZ: Suma transakcie s dvoma desatinnými miestami.
EN: Suma transakcie s dvoma desatinnými miestami.
EN: Suma transakcie s dvoma desatinnými miestami.
1000 (= 10 CZK/EUR)
ID klienta
reťazec
CZ: Jedinečné identifikačné číslo spoločnosti, ktoré získate v aplikácii alebo v uvítacom e-maile.
EN: Jedinečné identifikačné číslo spoločnosti, ktoré dostanete v aplikácii alebo v uvítacom e-maile.
EN: Jedinečné identifikačné číslo spoločnosti, ktoré dostanete v aplikácii alebo v uvítacom e-maile.
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
originReferenceNum
reťazec
CZ: Referenčné číslo s dĺžkou až 20 znakov – vhodné pre číslo faktúry, platby – je možné ho použiť na priradenie platby k predajom alebo objednávkam.
EN: Referenčné číslo s dĺžkou až 20 znakov – vhodné pre číslo faktúry, platbu – možno ho použiť na priraďovanie platieb k predajom alebo objednávkam.
EN: Referenčné číslo s dĺžkou až 20 znakov – vhodné pre číslo faktúry, platbu – možno ho použiť na priraďovanie platieb k predajom alebo objednávkam.
abc123
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
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
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/refund?amount=1000&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/refund&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é
emvAid
CZ: Identifikuje aplikáciu EMV používanú na spracovanie transakcie.
EN: Identifikuje aplikáciu EMV používanú na spracovanie transakcií.
EN: Identifikuje aplikáciu EMV používanú na spracovanie transakcií.
A0000000031010
typ karty
CZ: Identifikuje použitý typ karty.
EN: Určuje typ použitej karty.
EN: Určuje typ použitej karty.
VISA
MASTER
MASTER