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

{
  "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

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