# Rambursare plată efectuată (Refund)

**POST** `/v2/payments/{payId}/refund`

Creează o solicitare de rambursare pentru o plată existentă. Rambursarea poate fi **integrală** sau **parțială** (în funcție de parametrul `amount`).

***

#### Parametri cerere

**Parametru în path**

| Nume    | Tip           | Obligatoriu | Descriere                                              |
| ------- | ------------- | ----------- | ------------------------------------------------------ |
| `payId` | string (GUID) | da          | Identificatorul unic al plății înregistrate în sistem. |

**Parametri în body**

| Nume          | Tip              | Obligatoriu | Descriere                                                                                                                                                      |
| ------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `amount`      | number (zecimal) | nu          | Suma rambursării. Dacă este transmisă, se inițiază o **rambursare parțială** cu suma indicată. Dacă nu este transmisă, se inițiază o **rambursare integrală**. |
| `reason`      | string           | da          | Motivul pentru care se inițiază rambursarea (recomandat max. 500 caractere).                                                                                   |
| `callbackUrl` | string (URL)     | nu          | URL HTTPS către care sistemul va trimite un callback când rambursarea este **acceptată/procesată**.                                                            |

#### Request example

```json
{
  "amount": 50.61,
  "reason": "Reason for payment refund.",
  "callbackUrl": "https://www.example.com"
}
```

***

#### Parametri răspuns

**Obiect `result`**

| Nume       | Tip           | Descriere                                                        |
| ---------- | ------------- | ---------------------------------------------------------------- |
| `refundId` | string (GUID) | Identificatorul unic al rambursării create în sistem.            |
| `status`   | string (enum) | Statusul solicitării de rambursare. Valoare posibilă: `Created`. |

**Alte câmpuri**

| Nume     | Tip          | Descriere                                                  |
| -------- | ------------ | ---------------------------------------------------------- |
| `ok`     | boolean      | Indică dacă solicitarea a fost procesată cu succes.        |
| `errors` | array / null | Conține detalii despre erori (dacă există); altfel `null`. |

#### Response example

```json
{
  "result": {
    "refundId": "8ce09e40-2948-4225-a9c4-f277dbd587ea",
    "status": "Created"
  },
  "ok": true,
  "errors": null
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.maibmerchants.md/mia-qr-api/endpoint-uri/rambursare-plata/rambursare-plata-efectuata-refund.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.