Refunds
Return money to a customer, where the scheme allows it.
{
"payment_id": "3743881d-0fce-416c-b3de-8bc3f5d414b1",
"amount": 500,
"reason": "Item returned"
}Omit amount to refund the full remaining balance. Partial
refunds may be repeated up to the original amount.
Rules that differ by method
| Method | Refunds |
|---|---|
| iDEAL, Bancontact, MB WAY | Full and partial, 365 days |
| Przelewy24 | Full and partial, 90 days, then the customer claims from P24 |
| Cards | Full and partial, 180 days |
| Multibanco | Not possible |
| paysafecard | Payouts only, never a refund |
payment_not_settled. Cancel it instead if the
customer has not paid.Reversal: voiding a card payment
{
"reason": "Order cancelled before dispatch"
}A reversal voids a card payment before it settles at the scheme, rather than returning settled funds. It is the full amount only, it is usually free where a refund carries a scheme cost, and the customer sees the charge drop off instead of a separate credit. Use it the same day, while the payment is still reversible; once it has settled, use a refund. On acquirers that draw no distinction, a reversal simply behaves like a full refund.
A reversal is recorded as a full refund, so it appears in the refund
endpoints below and the fee accrual unwinds the same way. A partial
amount is refused with reversal_must_be_full.