Refunds and full reversals
Read the transaction with GET /transactions/{id} and transactions:read. Refunds require refunds:write and the sale’s financial UUID.
| Endpoint | When to use it |
|---|---|
| POST /transactions/{id}/refunds | A verified partial or full refund. |
| POST /transactions/{id}/reversal | A full reversal; refused after any applied refund. |
| Field | What to send |
|---|---|
| external_ref | A stable, distinct reference for the return document. |
| refunded_total | Actual money refunded. It may be zero for a purchase fully paid with benefits. |
| refunded_eligible_amount | The ORIGINAL eligible goods value before the Mereu benefit. |
| occurred_at / provider_refund_id | The real return time and identifier from your system. |
| reason | The verified reason, without personal data. |
Use the original sale’s item allocations, not the current program rules. For a regular /purchases import without a redeemed benefit, the returned eligible value matches the eligible amount paid.
Partial refunds allocate cumulatively with exact integer rounding; the final allocation closes the sale. Refunded cash may include returned noneligible payment within the original amount paid. The original currency and program are preserved.
Read GET /transactions/{refund_id} to check the refund’s status. Mereu does not instruct a bank or POS to send money: record the refund only after verifying the actual return in your system.