Aviz
Pro získání detailu transakce je nutné doptávat se pouze pomocí Inquiry requestu:
TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException
După primirea ID-ului tranzacției, aplicația dvs. trebuie să genereze și să trimită o cerere de tranzacție. Aplicația de plată va executa întregul proces de plată și va returna rezultatul. În versiunile mai vechi (sub versiunea 1.2), comunicarea sincronă era utilizată pentru a obține rezultatul tranzacției (funcția de ascultare este depășită). Pentru noua versiune, comunicarea este asincronă, metoda getTransactionState fiind utilizată pentru a obține starea curentă a tranzacției.
void transactionRequestV2(String transactionRequesJsonString, ITransactionResultListener listener) aruncă RemoteException
Cerere [TransactionRequestV2Entity]
În funcție de tipul tranzacției, următoarele câmpuri sunt obligatorii/opționale/opționale:
[(M) obligatoriu, (O) opțional)]]
CARD
CONT_PLATA
BLIK_PAYMENT
PAYMENT_GATEWAY
Aviz
Formatul pentru toate sumele este cu două zecimale, astfel încât, de exemplu, 50 CZK trebuie completat ca 5000.
Descrierea câmpurilor
sumă
Suma determină volumul tranzacției. Această sumă este calculată în moneda națională utilizată de terminal. Formatul este cu două zecimale, astfel încât, de exemplu, 50 CZK trebuie completat ca 5000.
TipAmount
În restaurante, puteți solicita clientului să adauge un bacșiș, care este introdus în sistemul dumneavoastră. Această sumă este apoi adăugată la suma inițială introdusă de comerciant.
ID tranzacție
Un ID unic generat de aplicația de plată în timpul procesului de înregistrare a tranzacției.
clientID
Tipul tranzacției
Tipul de tranzacție definește tipul de tranzacție pe care doriți să o inițiați. Valorile disponibile sunt:
- VÂNZARE(1)
- VOID(2)
- REFUND(3) – since version 1.75.4, AIDL 1.28
- CLOSE_BATCH(4)
originTransactionID
Acesta este utilizat pentru a anula o tranzacție și trebuie să conțină ID-ul tranzacției pe care doriți să o anulați.
origineNumReferință
Acest câmp este opțional și poate fi completat cu un număr de referință - orice șir AN cu maximum 20 de caractere. Acest șir este vizibil în toate rapoartele privind tranzacțiile și ajută departamentele de contabilitate să coreleze plățile cu comenzile. Diacriticele nu sunt acceptate.
anulareMode
2 - Tranzacții mai vechi
printarePaymentApp
Definește dacă chitanța este transmisă clientului de aplicația dvs. sau de GP tom. Valoarea implicită este true (adică GP tom va oferi metoda de transmitere a chitanței către client). Dacă trimiteți o valoare de „false“, vom returna utilizatorul către aplicația dvs. imediat după tranzacție și depinde de dvs. să transmiteți chitanța.
clientInfo
Dacă trimiteți chitanța direct din aplicația GP tom, este posibil să precompletați e-mailul sau numărul de telefon al clientului prin API.
preferabilReceiptType
În cazul trimiterii unei chitanțe din aplicația GP tom, este posibil să se predefinească metoda de trimitere a chitanței prin API. Valorile posibile sunt:
- TELEFON
- QR
- IMPRIMARE
TipCollect
Un câmp opțional care afișează ecranul de introducere a bacșișului în aplicația GP tom. După introducerea bacșișului în aplicație, este afișat ecranul pentru atașarea cardului. Pentru a afișa acest ecran, trebuie să aveți activată și funcția de bacșiș în aplicație
Metoda de plată
Începând cu versiunea 1.64.5, am adăugat posibilitatea de a apela metode de plată suplimentare prin API-ul app2app utilizând câmpul PaymentMethod. Opțiunile actuale sunt:
CASH - plăți în numerar
CARD - plăți cu cardul
ACCOUNT_PAYMENT - plata prin factură (metodă de plată nouă pentru piața din CZ)
Dacă câmpul nu este completat, valoarea implicită este setată la CARD.