Executare plată one-click
Last updated
Last updated
Parametru | Tip | Descriere |
---|---|---|
Parametru | Tip | Descriere |
---|---|---|
https://api.maibmerchants.md/v1/execute-oneclick
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
id
nu
string(36)
ID produs
name
nu
string(128)
Nume produs
price
nu
number(decimal)
Preț produs în format X.XX
quantity
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.
result
object
Obiect care conține identificatorul tranzacției și link-ul pentru redirecționare Cumpărător
payId
string
Identificatorul tranzacției atribuit de către maib ecomm
orderId
string
Identificatorul comenzii de pe website/app
payUrl
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
errorCode
string
Cod eroare
errorMessage
string
Descriere eroare
errorArgs
object
Obiectul conține parametri cu detalii despre eroare
result
object
Obiect care conține datele tranzacției
payId
string
Identificatorul tranzacției atribuit de către maib ecomm
billerId
string
Identificatorul cardului salvat în maib ecomm.
orderId
string
Identificatorul comenzii de pe website/app
status
string
statusCode
string
Codul stării tranzacției
statusMessage
string
Detalii despre starea tranzacției
threeDs
string
rrn
string
RRN - Identificatorul tranzacției generat de către maib ecomm
approval
string
Approval Code - Identificatorul de aprobare a tranzacției generat de către banca emitentă a cardului
cardNumber
string
Numărul cardului hașurat
amount
number(decimal)
Suma tranzacției în format X.XX
currency
string
Valuta tranzacției (MDL/EUR/USD)
signature
string
Semnătură validare răspuns.