Documentation contents

Integration guide

Refunds and full reversals

Read the transaction with GET /transactions/{id} and transactions:read. Refunds require refunds:write and the sale’s financial UUID.

EndpointWhen to use it
POST /transactions/{id}/refundsA verified partial or full refund.
POST /transactions/{id}/reversalA full reversal; refused after any applied refund.
FieldWhat to send
external_refA stable, distinct reference for the return document.
refunded_totalActual money refunded. It may be zero for a purchase fully paid with benefits.
refunded_eligible_amountThe ORIGINAL eligible goods value before the Mereu benefit.
occurred_at / provider_refund_idThe real return time and identifier from your system.
reasonThe 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.