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ý:
Vytvoření transakce
Transakciu je možné iniciovať volaním:
gptom://transaction/create?…
kde jsou použity následující parametry pro sestavení zprávy:
Premenná/Pole
Formát
Popis
Príklad
suma
POVINNÉ
POVINNÉ
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: Volitelná kontrola přihlášeného uživatele. Zde se kontroluje API klíč terminálu.
EN: Optional check of the logged in user. Here the terminal API key is checked.
EN: Optional check of the logged in user. Here the terminal API key is checked.
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.
Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
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.
Defines whether the receipt is passed to the client by your application or GP tom. The default value is true (i.e. GP will offer a way to pass the receipt to the client). If you send a value of "false", we return the user to your app immediately after the transaction and it's up to you to pass the receipt.
Defines whether the receipt is passed to the client by your application or GP tom. The default value is true (i.e. GP will offer a way to pass the receipt to the client). If you send a value of "false", we return the user to your app immediately after the transaction and it's up to you to pass the receipt.
pravda/nepravda
tipAmount
long
CZ: V restauracích můžete požádat zákazníka o přidání spropitného, kde spropitného je zadáno z Vašeho systému. Tato částka se pak přičte k původní částce zadané obchodníkem.
EN: In restaurants, you can ask the customer to add a tip, where the tip is entered in your system. This amount is then added to the original amount entered by the merchant.
EN: In restaurants, you can ask the customer to add a tip, where the tip is entered in your system. This amount is then added to the original amount entered by the merchant.
1000 (=10CZK/EUR)
redirectUrl
reťazec
CZ: URL vaší aplikace na kterou přesměrujeme klienta po dokončení platby.
EN: The URL of your application to which we will redirect the client after completing the payment.
EN: The URL of your application to which we will redirect the client after completing the payment.
fb://success
tipCollect
bool
CZ: Volitelné pole, které vyvolává obrazovku zadání spropitného v aplikaci GP tom. Po zadání spropitného v aplikaci se následně zobrazí obrazovka pro přiložení karty. Pro vyvolání této obrazovky je potřeba mít také aktivované spropitné v aplikaci.
EN: An optional field that brings up the tip entry screen in the GP tom application. After entering the tip in the application, a screen for attaching the card will be displayed. You also need to have tipping enabled in the app to bring up this screen.
EN: An optional field that brings up the tip entry screen in the GP tom application. After entering the tip in the application, a screen for attaching the card will be displayed. You also need to have tipping enabled in the app to bring up this screen.
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 transakce definuje typ transakce, kterou chcete zahájit. Dostupné hodnoty jsou:
EN:Transaction Type defines the type of transaction you want to initiate. Available values are:
CASH
KARTA
ACCOUNT_PAYMENT
BLIK_PAYMENT
PAYMENT_GATEWAY
EN:Transaction Type defines the type of transaction you want to initiate. Available values are:
CASH
KARTA
ACCOUNT_PAYMENT
BLIK_PAYMENT
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: Dává odpověď v jakém stavu skončil daný požadavek
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 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
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: Identifies used card type.
EN: Identifies used card type.
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: Udává celkovou čásku transakce (včetně 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 - approved transaction
-1 - declined transaction
-1 - declined transaction
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
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.
accepted