Returnare plată

Returnarea plății poate fi parțială sau totală și poate fi efectuată doar o singura dată.

În cazul în care plata a fost returnată parțial iar ulterior a venit necesitatea de a returna și restul sumei va trebui să vă adresați la echipa de suport.

API endpoint (POST)
https://api.maibmerchants.md/v1/refund

Parametri pentru request (body)

Parametru	Obligatoriu	Tip	Descriere
payId	DA	string(UUID)	Identificatorul tranzacției care trebuie returnată.
refundAmount	NU	number(decimal)	Suma care trebuie returnată Cumpărătorului, în format X.XX De exemplu: 10.25 (currency=MDL) -> 10 lei și 25 bani. Această sumă poate fi mai mică sau egală cu suma tranzacției. Dacă acest parametru nu este transmis va fi returnată toată suma tranzacției.

Exemplu

{
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"refundAmount": 10.25
}

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
orderId	string	Identificatorul comenzii de pe website/app
status	string	Stare returnare plată OK - returnare reușită
statusCode	string	Codul stării tranzacției
statusMessage	string	Detalii despre starea tranzacției
refundAmount	number(decimal)	Suma returnată Cumpărătorului în format X.XX
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",
"orderId": "123",
"status": "OK",
"statusCode": "400",
"statusMessage": "Accepted (for reversal)",
"refundAmount": 10.25
},
"ok": true
}

Cu erori

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