Co přesně je dávka? Každá transakce, kterou vytvoříte, patří do tzv. dávky. Stejně jako účtenka má každá dávka své číslo a je balíčkem transakcí. Uzávěrka je administrativní operace, pomocí které terminál uzavře dávku a vyzve systémy, aby se dávka uzavřela a otevřela nová.
Inicializace uzávěrky
Transakci lze iniciovat zavoláním:
gptom://batch/close?…
kde jsou použity následující parametry pro sestavení zprávy:
Proměnná
Formát
Popis
Příklad
clientID
string
redirectUrl
string
URL vaší aplikace na kterou přesměrujeme klienta po dokončení storna
fb://Success
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
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
Příklad volání:
gptom://batch/close?preferableReceiptType=QR&redirectUrl=gp://batch/close&clientEmail=info@gptom.com&clientID=223&printByPaymentApp=true&clientPhone=+420606505404