Executare plată one-click
API endpoint (POST) |
---|
https://api.maibmerchants.md/v1/execute-oneclick |
Parametri pentru request (body)
Parametru | Obligatoriu | Tip | Descriere |
---|---|---|---|
billerId | DA | string(UUID) | Identificatorul cardului salvat în maib ecomm. |
amount | DA | number(decimal) | Suma tranzacției în formatul X.XX De exemplu: 10.25 (valuta MDL) -> 10 lei și 25 bani |
currency | DA | string (3) | Valuta tranzacției (MDL/EUR/USD) |
clientIp | DA | string(15) | IP Cumpărător |
language | NU | string(2) | Limba în care va fi afișată pagina maib ecomm checkout. Valori posibile: ro/en/ru. Dacă acest parametru nu este transmis, pagina va fi afișată în limba engleză. |
description | NU | string(124) | Descrierea plății. Se afișează pe pagina maib ecomm checkout |
orderId | NU | string(36) | Identificatorul comenzii de pe website/app |
delivery | NU | number(decimal) | Costul livrării în format X.XX |
items | NU | array max. 50 items | Produsele sau serviciile din coșul Cumpărătorului |
| nu | string(36) | ID produs |
| nu | string(128) | Nume produs |
| nu | number(decimal) | Preț produs în format X.XX |
| nu | integer(32) | Cantitatea produselor |
callbackUrl | NU | string(2048) | Link-ul unde Merchant-ul va primi răspunsul final cu starea și datele tranzacției. Dacă nu se transmite acest parametru valoarea sa va fi preluată din maibmerchants. |
okUrl | NU | string(2048) | Link-ul unde Cumpărătorul va fi redirecționat dacă tranzacția este reușită. (GET request: okUrl + payId&orderId&billerId) Dacă nu se transmite acest parametru valoarea sa va fi preluată din maibmerchants. |
failUrl | NU | string(2048) | Link-ul unde Cumpărătorul va fi redirecționat dacă tranzacția a eșuat. (GET request: failUrl + payId&orderId&billerId) Dacă nu se transmite acest parametru valoarea sa va fi preluată din maibmerchants. |
Exemplu
Parametri răspuns intermediar
Parametru | Tip | Descriere |
---|---|---|
result | object | Obiect care conține identificatorul tranzacției și link-ul pentru redirecționare Cumpărător |
| string | Identificatorul tranzacției atribuit de către maib ecomm |
| string | Identificatorul comenzii de pe website/app |
| string | Link-ul către pagina maib ecomm checkout unde Cumpărătorul trebuie să fie redirecționat pentru a introduce CVV2/CVC2 (poate fi exclus) și va trece autentificarea 3DS. |
ok | boolean | Stare procesare request/tranzacție: true - nu sunt erori; false - sunt erori (detaliile despre erori vor fi în afișate în errors); |
errors | array | Erori procesare request/tranzacție. Tabelul cu erori |
| string | Cod eroare |
| string | Descriere eroare |
| object | Obiectul conține parametri cu detalii despre eroare |
Exemplu răspuns intermediar
Răspuns final (pe Callback URL)
Parametru | Tip | Descriere |
---|---|---|
result | object | Obiect care conține datele tranzacției |
| string | Identificatorul tranzacției atribuit de către maib ecomm |
| string | Identificatorul cardului salvat în maib ecomm. |
| string | Identificatorul comenzii de pe website/app |
| string | |
| string | Codul stării tranzacției |
| string | Detalii despre starea tranzacției |
| string | |
| string | RRN - Identificatorul tranzacției generat de către maib ecomm |
| string | Approval Code - Identificatorul de aprobare a tranzacției generat de către banca emitentă a cardului |
| string | Numărul cardului hașurat |
| number(decimal) | Suma tranzacției în format X.XX |
| string | Valuta tranzacției (MDL/EUR/USD) |
signature | string | Semnătură validare răspuns. |
Exemplu răspuns final (pe Callback URL)
Last updated