Értesítés
A tranzakció részleteinek lekérdezéséhez kizárólag „Inquiry request” segítségével lehet lekérdezést indítani:
TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException
A tranzakciós azonosító megkapása után az alkalmazásnak létre kell hoznia és el kell küldenie a tranzakciós kérést. A fizetési alkalmazás elindítja a teljes fizetési folyamatot, majd visszaküldi az eredményt. A régebbi verziókban (1.2-nél korábbiakban) a tranzakció eredményének lekéréséhez szinkron kommunikációt használtak (a figyelési funkció elavult). Az új verzióban az kommunikáció aszinkron, ahol a tranzakció aktuális állapotának lekéréséhez a getTransactionState metódust használják.
void transactionRequestV2(String transactionRequestJsonString, 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/opcionálisak:
[(M) kötelező, (O) választható)]
KÁRTYA
ACCOUNT_PAYMENT
BLIK_FIZETÉS
PAYMENT_GATEWAY
Értesítés
Minden összeg formátuma két tizedesjegyig terjed, így például 50 Kč-t 5000-ként kell beírni.
A mezők leírása
összeg
Az összeg határozza meg a tranzakció értékét. Ezt az összeget a terminál által használt helyi pénznemben kell kiszámítani. A formátum két tizedesjegyig terjed, így például 50 Kč-t 5000-ként kell beírni.
TipAmount
Azokban az éttermekben, ahol a borravaló a rendszerben be van állítva, megkérheti a vendéget, hogy adjon borravalót. Ezt az összeget a rendszer hozzáadja a kereskedő által megadott eredeti összeghez.
tranzakcióazonosító
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, hogy milyen típusú tranzakciót kíván kezdeményezni. A rendelkezésre álló értékek a következők:
- AKCIÓ(1)
- VOID(2)
- REFUND(3) – az 1.75.4-es verziótól kezdve, AIDL 1.28
- CLOSE_BATCH(4)
originTransactionID
A tranzakciók visszavonására szolgál, és tartalmaznia kell a visszavonni kívánt tranzakció azonosítóját.
originReferenceNum
Ez a mező opcionális, és kitölthető hivatkozási számmal – bármilyen, legfeljebb 20 karakterből álló AN karakterlánccal. Ez a karakterlánc minden tranzakciós áttekintésben megjelenik, és segít a könyvelési osztályoknak a befizetéseket a megrendelésekhez rendelni. A diakritikus jelek használata nem támogatott.
cancelMode
2 – Régebbi tranzakciók
printByPaymentApp
Meghatározza, hogy az alkalmazásod vagy a GP tom adja-e át a nyugtát az ügyfélnek. Az alapértelmezett érték „true“ (vagyis a GP tom kínálja fel az ügyfélnek a nyugta átadásának módját). Ha „false” értéket adsz meg, a tranzakciót követően azonnal visszavezetjük a felhasználót az alkalmazásodba, és a nyugta átadása rajtad múlik.
clientInfo
Ha a számlát közvetlenül a GP tom alkalmazásból küldi el, az API segítségével előre kitöltheti az ügyfél e-mail-címét vagy telefonszámát.
preferableReceiptType
Ha a számlát a GP tom alkalmazásból küldik el, az API-n keresztül előre meg lehet határozni a számla elküldésének módját. A lehetséges értékek a következők:
- TELEFON
- QR
- NYOMTATÁS
Fő fogadásCollect
Opcionális mező, amely a GP tom alkalmazásban megnyitja a borravaló megadására szolgáló képernyőt. Miután az alkalmazásban megadták a borravalót, megjelenik a kártya beolvasására szolgáló képernyő. E képernyő megjelenítéséhez az alkalmazásban a borravaló funkciót is engedélyezni kell.
Fizetési mód
Az 1.64.5-ös verziótól kezdve lehetőséget biztosítunk további fizetési módok hívására az app2app API-n keresztül a PaymentMethod tömb segítségével. A jelenlegi lehetőségek a következők:
CASH – készpénzes fizetések
CARD – kártyás fizetések
ACCOUNT_PAYMENT – számlás fizetés (új fizetési mód a cseh piacon)
Ha a mezőt nem töltik ki, az alapértelmezett érték CARD-ra van beállítva.