Upozornenie
Na získanie podrobností o transakcii je potrebné zaslať žiadosť výlučne prostredníctvom žiadosti o informácie (Inquiry request):
TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException
Po prijatí ID transakcie by vaša aplikácia mala vygenerovať a odoslať žiadosť o transakciu. Platobná aplikácia spustí celý platobný proces a vráti výsledok. V starších verziách (nižších ako verzia 1.2) sa na získanie výsledku transakcie používala synchronná komunikácia (funkcia naslouchání je zastaraná). V novej verzii je komunikácia asynchrónna, pričom na získanie aktuálneho stavu transakcie sa používa metóda getTransactionState.
void transactionRequestV2(String transactionRequesJsonString, ITransactionResultListener listener) throws RemoteException
Žiadosť [TransactionRequestV2Entity]
V závislosti od typu transakcie sú nasledujúce polia povinné/nepovinné/voliteľné:
[(M) povinné, (O) voliteľné)]
KARTA
ACCOUNT_PAYMENT
BLIK_PLATBA
PAYMENT_GATEWAY
Upozornenie
Všetky sumy sa uvádzajú s dvoma desatinnými miestami, takže napríklad 50 Kč by sa malo vyplniť ako 5000.
Popis polí
suma
Suma určuje objem transakcie. Táto suma sa počíta v domácej mene, ktorú používa terminál. Formát je na dve desatinné miesta, takže napríklad 50 Kč by sa malo vyplniť ako 5000.
tipAmount
V reštauráciách môžete požiadať zákazníka o pridaní spropitného, pričom spropitné je zadané vo vašom systéme. Táto suma sa potom pripočíta k pôvodnej sume zadané predajcom.
transactionID
Jedinečné ID vygenerované platobnou aplikáciou počas procesu registrácie transakcie.
ID klienta
typ transakcie
Typ transakcie definuje typ transakcie, ktorú chcete začať. K dispozícii sú nasledujúce hodnoty:
- VÝPREDAJ(1)
- VOID(2)
- REFUND(3) – od verzie 1.75.4, AIDL 1.28
- CLOSE_BATCH(4)
originTransactionID
Používa sa na zrušenie transakcie a malo by obsahovať ID transakcie, ktorú chcete zrušiť.
originReferenceNum
Toto pole je nepovinné a možno do neho vyplniť referenčné číslo – ľubovoľný reťazec AN s maximálne 20 znakmi. Tento reťazec je viditeľný vo všetkých prehľadoch transakcií a pomáha účtovným oddeleniam priradiť platby k objednávkam. Diakritické znamienka nie sú podporované.
režim zrušenia
2 – Staršie transakcie
tlač cez platobnú aplikáciu
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 presmerujeme používateľa späť do vašej aplikácie a odovzdanie účtenky je na vás.
clientInfo
Ak budete odosielať účtenku priamo z aplikácie GP tom, je možné prostredníctvom API predvyplniť e-mailovú adresu alebo telefónne číslo zákazníka.
preferovaný typ potvrdenia
V prípade odoslania účtenky z aplikácie GP je možné prostredníctvom API vopred definovať spôsob odoslania účtenky. Možné hodnoty sú:
- TELEFÓN
- QR
- TLAČ
tipCollect
Voliteľné pole, ktoré v aplikácii GP tom vyvolá obrazovku na zadanie spropitného. Po zadaní spropitného v aplikácii sa následne zobrazí obrazovka na priloženie karty. Na vyvolanie tejto obrazovky je potrebné mať v aplikácii aktivovanú funkciu spropitného.
Spôsob platby
Od verzie 1.64.5 sme pridali možnosť volať ďalšie platobné metódy prostredníctvom rozhrania app2app API pomocou poľa PaymentMethod. Aktuálne možnosti sú:
CASH – platby v hotovosti
CARD – platby kartou
ACCOUNT_PAYMENT – platba z účtu (nový spôsob platby pre český trh)
Ak sa pole nevyplní, predvolená hodnota je nastavená na CARD.