Transakce storno patří mezi základní platební operace, která zajišťuje storno již provedené platební transakce zpět na účet držitele karty.
Průběh storna je následující:
Vytvoření storna
Transakci lze iniciovat zavoláním:
gptom://transaction/cancel?…
kde jsou použity následující parametry pro sestavení zprávy včetně amsID, které je přiděleno pro každou platbu:
Proměnná
Formát
Popis
Příklad
clientID
string
amsID
MANDATORY
MANDATORY
string
unikátní amsID, které dostanete při platbě
redirectUrl
string
URL vaší aplikace na kterou přesměrujeme klienta po dokončení storna
fb://Success
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
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
clientPhone
string
telefonní číslo klienta
+420606505404
clientEmail
string
emailová adresa klienta
info@gptom.com
Příklad volání:
gptom://transaction/cancel?amsID=123&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/cancel&clientEmail=info@gptom.com