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	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

Parametru	Tip	Descriere
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

Exemplu răspuns intermediar

Fără erori

{
"result": {
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"orderId": "123",
"payUrl": "https://maib.ecommerce.md/ecomm01/ClientHandler?trans_id=rEsfhyIk8s9ypxkcS9fj/3C8FqA="
},
"ok": true
}

Cu erori

Răspuns final (pe Callback URL)

Parametru	Tip	Descriere
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	Starea tranzacției
statusCode	string	Codul stării tranzacției
statusMessage	string	Detalii despre starea tranzacției
threeDs	string	Rezultatul autentificării 3-D Secure
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"
}