> For the complete documentation index, see [llms.txt](https://docs.maibmerchants.md/e-commerce/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maibmerchants.md/e-commerce/ro/returnare-plata.md).

# 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](mailto:ecom@maib.md).

| API endpoint (POST)                      |
| ---------------------------------------- |
| <https://api.maibmerchants.md/v1/refund> |

### **Parametri pentru request (body)**

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

**Exemplu**

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

### **Parametri răspuns**

<table><thead><tr><th width="214">Parametru</th><th width="189.33333333333331">Tip</th><th>Descriere</th></tr></thead><tbody><tr><td>result</td><td>object</td><td>Obiect care conține datele tranzacției</td></tr><tr><td><ul><li>payId</li></ul></td><td>string</td><td>Identificatorul tranzacției atribuit de către <strong>maib ecomm</strong> </td></tr><tr><td><ul><li>orderId</li></ul></td><td>string</td><td>Identificatorul comenzii de pe website/app</td></tr><tr><td><ul><li>status</li></ul></td><td>string</td><td><p><a href="/e-commerce/ro/starea-tranzactiei-si-3d-secure.md#starea-tranzactiei">Stare returnare plată</a></p><p>OK - returnare reușită</p></td></tr><tr><td><ul><li>statusCode</li></ul></td><td>string</td><td>Codul stării tranzacției</td></tr><tr><td><ul><li>statusMessage</li></ul></td><td>string</td><td>Detalii despre starea tranzacției</td></tr><tr><td><ul><li>refundAmount</li></ul></td><td>number(decimal)</td><td>Suma returnată Cumpărătorului în format <strong>X.XX</strong></td></tr><tr><td>ok</td><td>boolean</td><td><p>Stare procesare request/tranzacție.</p><p><em>true</em> - nu sunt erori</p><p><em>false -</em> sunt erori (detaliile despre erori vor fi în afișate în <em>errors)</em></p></td></tr><tr><td>errors</td><td>array</td><td>Erori procesare request/tranzacție. <a href="/e-commerce/ro/erori/erori-api.md"><mark style="color:blue;">Tabelul cu erori</mark></a></td></tr><tr><td><ul><li>errorCode</li></ul></td><td>string</td><td>Cod eroare</td></tr><tr><td><ul><li>errorMessage</li></ul></td><td>string</td><td>Descriere eroare</td></tr><tr><td><ul><li>errorArgs</li></ul></td><td>object</td><td>Obiectul conține parametri cu detalii despre eroare</td></tr></tbody></table>

**Exemplu răspuns**

{% tabs %}
{% tab title="Fără erori" %}

```json
{
"result": {
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"orderId": "123",
"status": "OK",
"statusCode": "400",
"statusMessage": "Accepted (for reversal)",
"refundAmount": 10.25
},
"ok": true
}
```

{% endtab %}

{% tab title="Cu erori" %}

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

{% endtab %}
{% endtabs %}