Transakce prodej je základní platební operace, která zajišťuje převod stanovené částky z bankovního účtu držitele karty na účet obchodníka.
Pokud jde o průběh platby, postup je následující:
Vytvoření transakce
Transakci lze iniciovat zavoláním:
gptom://transaction/create?…
kde jsou použity následující parametry pro sestavení zprávy:
Proměnná
Formát
Popis
Příklad
amount
MANDATORY
MANDATORY
long
částka transakce s dvěma desetinnými místy
1000 (=10CZK/EUR)
clientID
string
originReferenceNum
string
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
printByPaymentApp
bool
Definuje, zda účtenku klientovi předá vaše aplikace nebo GP tom. Výchozí hodnota je true (tedy GP tom nabídne způsob předání účtenky klientovi). Pokud pošlete hodnotu “false”, ihned po transakci vrátíme uživatele do vaší aplikace a předání účtenky je na vás.
true/false
tipAmount
long
V restauracích můžete požádat zákazníka o přidání spropitného, kde spropitného je zadána za Vašeho systému. Tato částka se pak přičte k původní částce zadané obchodníkem.
1000 (=10CZK/EUR)
redirectUrl
string
URL vaší aplikace na kterou přesměrujeme klienta po dokončení platby
fb://success
tipCollect
bool
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
true / false
preferableReceiptType
enum (sms,email,qr,print)
V případě odeslání účtenky z aplikace GP tom je možné přes API předdefinovat způsob odeslání účtnky. Možné hodnoty jsou:
PHONE
EMAIL
QR
PRINT
PHONE
QR
sms
clientPhone
string
telefonní číslo klienta
+420606505404
clientEmail
string
emailová adresa klienta
info@gptom.com
transactionType
string
Typ transakce definuje typ transakce, kterou chcete zahájit. Dostupné hodnoty jsou:
CASH
CARD
CASH
CARD
CASH/CARD
Příklad volání:
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