Po obdržení ID transakce by vaše aplikace měla vygenerovat a odeslat požadavek na transakci. Platební aplikace spustí celý platební proces a vrátí výsledek. Ve starších verzích (níže než verze 1.2.) byla k získání výsledku transakce použita synchronní komunikace (funkce naslouchání je zastaralá). Pro novou verzi je komunikace asynchronní, kde se pro získání aktuálního stavu transakce používá metoda getTransactionState.
void transactionRequestV2(String transactionRequesJsonString, ITransactionResultListener listener) throws RemoteException
Request [TransactionRequestV2Entity]
Na základě typu transakce jsou následující pole povinná/nepovinná/volitelná:
[(M) povinné, (O) volitelná)]
Upozornění
Formát pro všechny částky je na dvě desetinná místa, takže například 50 Kč by mělo být vyplněno jako 5000.
Popis polí
amount
Částka určuje objem transakce. Tato částka se počítá v domácí měně, kterou používá terminál. Formát je na dvě desetinná místa, takže například 50 Kč by mělo být vyplněno jako 5000.
tipAmount
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.
transactionID
Jedinečné ID generované platební aplikací během procesu registrace transakce.
clientID
transactionType
Typ transakce definuje typ transakce, kterou chcete zahájit. Dostupné hodnoty jsou:
- SALE(1)
- VOID(2)
- CLOSE_BATCH(4)
originTransactionID
Používá se pro storno transakce a měl by obsahovat ID transakce, kterou chcete zrušit.
originReferenceNum
Toto pole je volitelné a může být vyplněno referenčním číslem – libovolným řetězcem AN s maximálně 20 znaky. Tento řetězec je viditelný ve všech přehledech transakcí a pomáhá účetním oddělením spárovat platby s objednávkami. Diakritika není podporována.
cancelMode
2 – Older transactions
printByPaymentApp
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.
clientInfo
Pokud budete odesílat účtenku přímo z aplikace GP tom, je možné přes API předvyplnit email nebo tel. číslo zákazníka.
preferableReceiptType
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
- QR
tipCollect
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