# 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
}
```