Retururi și anulări integrale
Verifică tranzacția cu GET /transactions/{id} și permisiunea transactions:read. Pentru retururi, folosește refunds:write și UUID-ul financiar al vânzării.
| Endpoint | Când îl folosești |
|---|---|
| POST /transactions/{id}/refunds | Retur parțial sau integral verificat. |
| POST /transactions/{id}/reversal | Anulare integrală; este refuzată după un retur deja aplicat. |
| Câmp | Ce trimiți |
|---|---|
| external_ref | Referința stabilă și distinctă a documentului de retur. |
| refunded_total | Banii efectiv restituiți. Poate fi zero la o achiziție achitată integral prin beneficii. |
| refunded_eligible_amount | Valoarea ORIGINALĂ eligibilă a bunurilor returnate, înainte de beneficiul Mereu. |
| occurred_at / provider_refund_id | Momentul și identificatorul real al returului din sistemul tău. |
| reason | Motivul verificat, fără date personale. |
Folosește alocările articolelor din vânzarea inițială, nu regulile curente ale programului. La un import obișnuit /purchases, fără beneficii consumate, valoarea eligibilă returnată corespunde valorii eligibile achitate.
Retururile parțiale se alocă cumulativ, cu rotunjire întreagă exactă; ultima alocare închide vânzarea. Suma restituită poate include și partea neeligibilă returnată, în limita plății inițiale. Moneda și programul inițial se păstrează.
Citește GET /transactions/{refund_id} pentru starea returului. Mereu nu trimite bani către bancă sau POS: înregistrează returul numai după verificarea restituirii în sistemul tău.