A tranzakció azonosítójának kézhezvétele után az alkalmazásnak tranzakciós kérelmet kell generálnia és elküldenie. A fizetési alkalmazás lefuttatja a teljes fizetési folyamatot, és visszaküldi az eredményt. A régebbi verziókban (1.2 verzió alatt) szinkron kommunikációt használtak a tranzakció eredményének megszerzésére (a figyelő funkció elavult). Az új verzió esetében a kommunikáció aszinkron, ahol a getTransactionState metódus segítségével kapjuk meg a tranzakció aktuális állapotát.
void transactionRequestV2(String transactionRequesJsonString, ITransactionResultListener listener) throws RemoteException
Kérés [TransactionRequestV2Entity]
A tranzakció típusától függően a következő mezők kötelezőek/nem kötelezőek/nem kötelezőek:
[(M) kötelező, (O) választható)]]
CARD
ACCOUNT_PAYMENT
Figyelmeztetés
Az összes összeg formátumát két tizedesjegy pontossággal kell megadni, így például 50 CZK-t 5000-ként kell beírni.
A mezők leírása
összeg
Az összeg határozza meg a tranzakció volumenét. Ez az összeg a terminál által használt hazai pénznemben kerül kiszámításra. A formátum két tizedesjegyig terjed, így például 50 CZK-t 5000-ként kell beírni.
TipAmount
Éttermekben megkérheti a vendéget, hogy adjon borravalót, ahol a borravaló az Ön rendszere szerint kerül beírásra. Ez az összeg ezután hozzáadódik a kereskedő által eredetileg megadott összeghez.
transactionID
A fizetési alkalmazás által a tranzakció regisztrációja során generált egyedi azonosító.
clientID
transactionType
A Tranzakció típusa meghatározza a kezdeményezni kívánt tranzakció típusát. A rendelkezésre álló értékek a következők:
- ELADÓ(1)
- VOID(2)
- CLOSE_BATCH(4)
originTransactionID
A tranzakció törlésére szolgál, és a törlendő tranzakció azonosítóját kell tartalmaznia.
originReferenceNum
Ez a mező nem kötelező, és egy hivatkozási számmal tölthető ki - bármilyen AN karakterlánc, legfeljebb 20 karakterrel. Ez a karakterlánc minden tranzakciós jelentésben látható, és segít a könyvelési részlegeknek a kifizetések és a megrendelések összevetésében. A diakritikus karakterek nem támogatottak.
cancelMode
2 - Régebbi tranzakciók
printByPaymentApp
Meghatározza, hogy a nyugtát az Ön alkalmazása vagy a GP tom adja át az ügyfélnek. Az alapértelmezett érték true (azaz a GP tom felajánlja a nyugta átadásának módszerét az ügyfélnek). Ha "false" értéket küld, akkor a tranzakciót követően azonnal visszaadjuk a felhasználónak az alkalmazásodnak, és a nyugta átadása már a te feladatod.
clientInfo
Ha közvetlenül a GP tom alkalmazásból küldi el a nyugtát, az API-n keresztül lehetőség van az ügyfél e-mail címének vagy telefonszámának előzetes kitöltésére.
preferableReceiptType
A GP tom alkalmazásból történő nyugta küldés esetén lehetőség van a nyugta API-n keresztül történő küldésének módját előre meghatározni. A lehetséges értékek a következők:
- TELEFON
- QR
tipCollect
Egy opcionális mező, amely a GP tom alkalmazásban megjeleníti a borravaló beviteli képernyőt. Miután beírta a borravalót az alkalmazásban, megjelenik a kártya csatolásának képernyője. Ahhoz, hogy ez a képernyő megjelenjen, a borravalónak is engedélyezve kell lennie az alkalmazásban.
PaymentMethod
Az 1.64.5-ös verzió óta lehetőségünk van további fizetési módok hívására az app2app API-n keresztül a PaymentMethod mező használatával. A jelenlegi lehetőségek a következők:
CASH - készpénzes fizetés
CARD - kártyás fizetés
ACCOUNT_PAYMENT - számlafizetés (új fizetési mód a CZ piacon).
Ha a mező nincs kitöltve, az alapértelmezett érték CARD.