Predajná transakcia je základná platobná operácia, ktorá umožňuje prevod zadanej sumy z bankového účtu držiteľa karty na účet obchodníka.
Pokiaľ ide o proces platby, postup je nasledovný:
Vytvorenie transakcie
Transakciu možno iniciovať volaním:
gptom://transaction/create?…
kde sa na zostavenie správy použijú tieto parametre:
Premenná/polie
Formát/Format
Popis/popis
Príklad
amount
POVINNÝ
POVINNÝ
dlhý
CZ: Suma transakcie s dvoma desatinnými miestami.
SK: Suma transakcie s dvoma desatinnými miestami.
SK: Suma transakcie s dvoma desatinnými miestami.
1000 (=10CZK/EURO)
id klienta
string
originReferenceNum
string
CZ: Referenčné číslo do 20 znakov - vhodné pre číslo faktúry, platby - možno použiť na priradenie platby k predaji alebo objednávke.
Referenčné číslo do 20 znakov - vhodné pre číslo faktúry, platbu - môže byť použité pre vaše párovanie platieb s predajmi alebo objednávkami.
Referenčné číslo do 20 znakov - vhodné pre číslo faktúry, platbu - môže byť použité pre vaše párovanie platieb s predajmi alebo objednávkami.
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 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 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
tipAmount
dlhý
CZ: V reštauráciách môžete zákazníka požiadať, aby pridal prepitné, pričom prepitné sa zadáva z vášho systému. Táto suma sa potom pripočíta k pôvodnej sume zadanej obchodníkom.
SK: V reštauráciách môžete zákazníka požiadať, aby pridal prepitné, pričom prepitné sa zadáva z vášho systému. Táto suma sa potom pripočíta k pôvodnej sume zadanej obchodníkom.
SK: V reštauráciách môžete zákazníka požiadať, aby pridal prepitné, pričom prepitné sa zadáva z vášho systému. Táto suma sa potom pripočíta k pôvodnej sume zadanej obchodníkom.
1000 (=10CZK/EURO)
redirectUrl
string
CZ: URL adresa vašej aplikácie, na ktorú klienta presmerujeme po dokončení platby.
SK: Adresa URL vašej aplikácie, na ktorú klienta presmerujeme po dokončení platby.
SK: Adresa URL vašej aplikácie, na ktorú klienta presmerujeme po dokončení platby.
fb://success
TipCollect
bool
GP tomCZ: Nepovinné pole, ktoré v aplikácii vyvolá obrazovku na zadanie tipu. Po zadaní prepitného v aplikácii sa následne zobrazí obrazovka na priloženie karty. Na vyvolanie tejto obrazovky musíte mať v aplikácii povolené aj spropitné.
GP tom SK: Nepovinné pole, ktoré v aplikácii vyvolá obrazovku na zadanie prepitného. Po zadaní prepitného v aplikácii sa zobrazí obrazovka na priloženie karty. Na vyvolanie tejto obrazovky musíte mať v aplikácii povolené aj dávanie prepitného.
GP tom SK: Nepovinné pole, ktoré v aplikácii vyvolá obrazovku na zadanie prepitného. Po zadaní prepitného v aplikácii sa zobrazí obrazovka na priloženie karty. Na vyvolanie tejto obrazovky musíte mať v aplikácii povolené aj dávanie prepitného.
true / false
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
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
transactionType
string
SK: Typ transakcie definuje typ transakcie, ktorú chcete iniciovať.
Dostupné hodnoty sú: SK: Typ transakcie definuje typ transakcie, ktorú chcete iniciovať.
Dostupné hodnoty sú: CASH CARD
Dostupné hodnoty sú: SK: Typ transakcie definuje typ transakcie, ktorú chcete iniciovať.
Dostupné hodnoty sú: CASH CARD
HOTOVOSŤ/KARTA/ÚČET
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ť tieto polia:
Pole/Pole
Formát
Popis/popis
Príklad/vzor
STAV ÚLOHY
SK: Poskytuje informácie o tom, v ktorom štáte sa vaša žiadosť skončila. SK: Poskytuje informácie o tom, v ktorom štáte sa vaša ž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.
emvaid
CZ: Identifikuje aplikáciu EMV použitú na spracovanie transakcie.
SK: Identifikuje aplikáciu EMV použitú na spracovanie transakcie.
SK: Identifikuje aplikáciu EMV použitú na spracovanie transakcie.
A0000000031010
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
cardType
CZ: Identifikuje typ použitej karty.
SK: Identifikuje použitý typ karty.
SK: Identifikuje použitý typ karty.
VISA MASTER
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 - schválená transakcia -1 - zamietnutá transakcia
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: 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
authorizationCode
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
pinOk
true/false
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
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.
prijaté