Executare plată recurentă

API endpoint (POST)
https://api.maibmerchants.md/v1/execute-recurring

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

Exemplu

{
"billerId": "92f72473-f324-42d7-95fd-9c75c2947408",
"amount": 6.25,
"currency": "MDL",
"description": "Descriere",
"orderId": "123",
"delivery": 1.25,
"items": [
{
"id": "10",
"name": "Produs 1",
"price": 2.50,
"quantity": 2
}
]
}

Parametri răspuns

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

Fără erori

{
"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"
},
"ok": true
}

Cu erori

{
    "errors": [
        {
            "errorCode": "12001",
            "errorMessage": "Parameter 'amount' is invalid",
            "errorArgs": {
                "parameter": "amount"
            }
        }
    ],
    "ok": false
}