Cuprinsul documentației

Ghid de integrare

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.

EndpointCând îl folosești
POST /transactions/{id}/refundsRetur parțial sau integral verificat.
POST /transactions/{id}/reversalAnulare integrală; este refuzată după un retur deja aplicat.
CâmpCe trimiți
external_refReferința stabilă și distinctă a documentului de retur.
refunded_totalBanii efectiv restituiți. Poate fi zero la o achiziție achitată integral prin beneficii.
refunded_eligible_amountValoarea ORIGINALĂ eligibilă a bunurilor returnate, înainte de beneficiul Mereu.
occurred_at / provider_refund_idMomentul și identificatorul real al returului din sistemul tău.
reasonMotivul 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.