Executare plată one-click
https://api.maibmerchants.md/v1/execute-oneclick
Parametri pentru request (body)
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
DA
string(2)
Limba în care va fi afișată pagina maib ecomm checkout.
Valori posibile: ro/en/ru.
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.
Exemplu
{
"billerId": "92f72473-f324-42d7-95fd-9c75c2947408",
"clientIp": "135.250.245.121",
"amount": 6.25,
"currency": "MDL",
"description": "Descriere",
"orderId": "123",
"delivery": 1.25,
"items": [
{
"id": "10",
"name": "Produs",
"price": 2.50,
"quantity": 2
}
],
"callbackUrl": "https://example.com/callback",
"okUrl": "https://example.com/ok",
"failUrl": "https://example.com/fail"
}Parametri răspuns intermediar
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);
errorCode
string
Cod eroare
errorMessage
string
Descriere eroare
errorArgs
object
Obiectul conține parametri cu detalii despre eroare
Exemplu răspuns intermediar
{
"result": {
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"orderId": "123",
"payUrl": "https://maib.ecommerce.md/ecomm01/ClientHandler?trans_id=rEsfhyIk8s9ypxkcS9fj/3C8FqA="
},
"ok": true
}Răspuns final (pe Callback URL)
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
statusCode
string
Codul stării tranzacției
statusMessage
string
Detalii despre starea tranzacției
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.
Exemplu răspuns final (pe Callback URL)
{
"result": {
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"billerId": "92f72473-f324-42d7-95fd-9c75c2947408",
"orderId": "123",
"status": "OK",
"statusCode": "000",
"statusMessage": "Approved",
"rrn": "331711380059",
"approval": "327593",
"cardNumber": "510218******1124",
"amount": 6.25,
"currency": "MDL"
},
"signature": "xxxxxxxxxxxxxxxxxxxx"
}Last updated