Predajná transakcia je základná platobná operácia, ktorá zabezpečuje prevod stanovenej sumy z bankového účtu držiteľa karty na účet obchodníka.
Pokiaľ ide o priebeh platby, postup je nasledovný:
Vytvorenie transakcie
Transakciu je možné iniciovať volaním:
gptom://transaction/create?…
kde sa na zostavenie správy používajú nasledujúce parametre:
Premenná/Pole
Formát
Popis
Príklad
suma
POVINNÉ
POVINNÉ
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: Voliteľná kontrola prihláseného používateľa. Tu sa kontroluje API kľúč terminálu.
EN: Voliteľná kontrola prihláseného používateľa. Tu sa overuje API kľúč terminálu.
EN: Voliteľná kontrola prihláseného používateľa. Tu sa overuje API kľúč terminálu.
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.
Referenčné číslo s dĺžkou až 20 znakov – vhodné pre číslo faktúry, platbu – možno použiť na priradenie platieb k predajom alebo objednávkam.
Referenčné číslo s dĺžkou až 20 znakov – vhodné pre číslo faktúry, platbu – možno použiť na priradenie platieb k predajom alebo objednávkam.
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.
Určuje, či vaša aplikácia alebo GP odovzdá potvrdenku klientovi. Predvolená hodnota je "true" (t. j. GP ponúkne spôsob, ako odovzdať potvrdenku klientovi). Ak zadáte hodnotu „false“, ihneď po transakcii presmerujeme používateľa späť do vašej aplikácie a odovzdanie potvrdenia je na vás.
Určuje, či vaša aplikácia alebo GP odovzdá potvrdenku klientovi. Predvolená hodnota je "true" (t. j. GP ponúkne spôsob, ako odovzdať potvrdenku klientovi). Ak zadáte hodnotu „false“, ihneď po transakcii presmerujeme používateľa späť do vašej aplikácie a odovzdanie potvrdenia je na vás.
pravda/nepravda
tipAmount
dlhý
CZ: V reštauráciách môžete požiadať zákazníka o pridanie spropitného, pričom spropitné sa zadáva vo vašom systéme. Táto suma sa potom pripočíta k pôvodnej sume zadané predajcom.
EN: V reštauráciách môžete požiadať zákazníka, aby pridal spropitné, ktoré sa zadá do vášho systému. Táto suma sa potom pripočíta k pôvodnej sume zadané obchodníkom.
EN: V reštauráciách môžete požiadať zákazníka, aby pridal spropitné, ktoré sa zadá do vášho systému. Táto suma sa potom pripočíta k pôvodnej sume zadané obchodníkom.
1000 (= 10 CZK/EUR)
redirectUrl
reťazec
CZ: URL vašej aplikácie, na ktorú presmerujeme klienta po dokončení platby.
EN: URL adresa vašej aplikácie, na ktorú presmerujeme klienta po dokončení platby.
EN: URL adresa vašej aplikácie, na ktorú presmerujeme klienta po dokončení platby.
fb://success
tipCollect
bool
CZ: Voliteľné pole, ktoré v aplikácii GP tom otvorí obrazovku na zadanie spropitného. Po zadaní spropitného v aplikácii sa následne zobrazí obrazovka na priloženie karty. Na otvorenie tejto obrazovky je potrebné mať v aplikácii aktivovanú funkciu spropitného.
EN: Voliteľné pole, ktoré v aplikácii GP tom otvorí obrazovku na zadanie spropitného. Po zadaní spropitného v aplikácii sa zobrazí obrazovka na pripojenie karty. Na otvorenie tejto obrazovky musíte mať v aplikácii povolené spropitné.
EN: Voliteľné pole, ktoré v aplikácii GP tom otvorí obrazovku na zadanie spropitného. Po zadaní spropitného v aplikácii sa zobrazí obrazovka na pripojenie karty. Na otvorenie tejto obrazovky musíte mať v aplikácii povolené spropitné.
true / false
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
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
typ transakcie
reťazec
CZ: Typ transakcie definuje typ transakcie, ktorú chcete začať. K dispozícii sú nasledujúce hodnoty:
EN:Typ transakcie určuje typ transakcie, ktorú chcete iniciovať. K dispozícii sú nasledujúce hodnoty:
CASH
KARTA
ACCOUNT_PAYMENT
BLIK_PLATBA
PAYMENT_GATEWAY
EN:Typ transakcie určuje typ transakcie, ktorú chcete iniciovať. K dispozícii sú nasledujúce hodnoty:
CASH
KARTA
ACCOUNT_PAYMENT
BLIK_PLATBA
PAYMENT_GATEWAY
KARTA
Príklad volania:
gptom://transaction/create?originReferenceNum=12345&amount=2&clientID=123&tipCollect=true&preferableReceiptType=QR&redirectUrl=gp://transaction/create&printByPaymentApp=true&clientPhone=+420606505404&clientEmail=info@gptom.com&tipAmount=1
Odpoveď bude obsahovať nasledujúce polia:
Pole/Pole
Formát
Popis
Príklad
STATUS ÚLOHY
CZ: Uvádza, v akom stave bola daná požiadavka uzavretá
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.
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
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 karty
CZ: Identifikuje použitý typ karty.
EN: Určuje typ použitej karty.
EN: Určuje typ použitej karty.
VISA
MASTER
MASTER
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
CZ: Uvádza celkovú sumu transakcie (vrátane spropitné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 – schválená transakcia
-1 – zamietnutá transakcia
-1 – zamietnutá transakcia
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: 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
autorizačný kód
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
pinOk
pravda/nepravda
čí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
dccData:
stav
SK: Uvádza stav DCC. Ak je stav "ACCEPTED", transakcia prebehla cez DCC a musíte vyplniť údaje DCC na účtenke. Ak je stav "NOT_ACCEPTED", v takom prípade môžete údaje DCC ignorovať.
EN: Uvádza stav DCC. Ak je stav "ACCEPTED", transakcia bola vykonaná prostredníctvom DCC a do potvrdenia je potrebné vyplniť údaje DCC. Ak je stav "NOT_ACCEPTED", údaje DCC môžete ignorovať.
EN: Uvádza stav DCC. Ak je stav "ACCEPTED", transakcia bola vykonaná prostredníctvom DCC a do potvrdenia je potrebné vyplniť údaje DCC. Ak je stav "NOT_ACCEPTED", údaje DCC môžete ignorovať.
PRIJATÉ
NEPREJÍMANÉ
NEPREJÍMANÉ
mena
SK: Mena zákazníckej karty.
EN: Mena karty zákazníka.
EN: Mena karty zákazníka.
CZK
suma
SK: Suma transakcie v mene DCC – v mene karty zákazníka. Je potrebné ju zobraziť presne tak, ako je uvedená v odpovedi API, vrátane počtu desatinných miest.
EN: Suma transakcie v mene DCC – v mene karty zákazníka. Na potvrdení ju musíte uviesť presne tak, ako ste ju dostali v odpovedi API, vrátane správnych desatinných miest.
EN: Suma transakcie v mene DCC – v mene karty zákazníka. Na potvrdení ju musíte uviesť presne tak, ako ste ju dostali v odpovedi API, vrátane správnych desatinných miest.
61.02
značkovací jazyk
SK: Prirážka k konverznému kurzu. Je potrebné ju zobraziť presne tak, ako je uvedená v odpovedi API, vrátane počtu desatinných miest.
EN: Údaj o konverznej sadzbe. Na účtenke ho musíte uviesť presne tak, ako ste ho dostali v odpovedi API, vrátane správnych desatinných miest.
EN: Údaj o konverznej sadzbe. Na účtenke ho musíte uviesť presne tak, ako ste ho dostali v odpovedi API, vrátane správnych desatinných miest.
9.9
kurz
SK: Uvádza výmenný kurz. Táto hodnota je v miestnej mene terminálu. Je potrebné ju zobraziť presne tak, ako je uvedená v odpovedi API, vrátane počtu desatinných miest.
EN: Uvádza výmenný kurz. Táto hodnota je vyjadrená v miestnej mene terminálu. Na potvrdení ju musíte uviesť presne tak, ako ste ju dostali v odpovedi API, vrátane správneho počtu desatinných miest.
EN: Uvádza výmenný kurz. Táto hodnota je vyjadrená v miestnej mene terminálu. Na potvrdení ju musíte uviesť presne tak, ako ste ju dostali v odpovedi API, vrátane správneho počtu desatinných miest.
24.567
regionSchemaIndicator
CZ: Uvádza, či bola zákaznícka karta vydaná v rámci EÚ alebo mimo nej. Ak je hodnota "0" alebo "1", na účtenke sa musí zobraziť text "Markup". Ak je hodnota "2", na účtenke sa musí zobraziť "Markup over ECB rate“.
EN: Uvádza, či bola karta zákazníka vydaná v rámci EÚ alebo mimo nej. Ak je hodnota "0" alebo "1", na účtenke sa musí zobraziť text "Prirážka". Ak je hodnota "2", na účtenke sa musí zobraziť text "Prirážka nad kurzom ECB".
EN: Uvádza, či bola karta zákazníka vydaná v rámci EÚ alebo mimo nej. Ak je hodnota "0" alebo "1", na účtenke sa musí zobraziť text "Prirážka". Ak je hodnota "2", na účtenke sa musí zobraziť text "Prirážka nad kurzom ECB".
0
1
2
1
2
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.
prijaté