Transakce návrat umožňuje vrátit peníze na jakoukoliv kartu zákazníka bez potřeby dohledání předešlé prodejní transakce.
Průběh návratu je následující:
Vytvoření návratu
Transakciu je možné iniciovať volaním:
gptom://transaction/refund?…
kde jsou použity následující parametry pro sestavení zprávy včetně amsID, které je přiděleno pro každou platbu:
Premenná/Pole
Formát
Popis
Príklad
suma
long
CZ: Částka transakce s dvěma desetinnými místy.
EN: Transaction amount with two decimal places.
EN: Transaction amount with two decimal places.
1000 (=10CZK/EUR)
ID klienta
reťazec
CZ: Unikátní ID společnosti, které získáte v aplikaci nebo ve welcome emailu.
EN: The unique ID of the company that you will receive in the application or welcome email.
EN: The unique ID of the company that you will receive in the application or welcome email.
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 až 20 znaků - vhodné pro číslo faktury, platby - je možné použít pro vaše párování platby k prodejům či objednávkám.
EN: Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
EN: Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
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. Filled in if needed
EN: Tip. Filled in if needed
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 aplikaci EMV používanou pro zpracování transakce.
EN: Identifies the EMV app used for transaction processing.
EN: Identifies the EMV app used for transaction processing.
A0000000031010
typ karty
CZ: Identifikuje použitý typ karty.
EN: Identifies used card type.
EN: Identifies used card type.
VISA
MASTER
MASTER