Refund Order
POST/refunds
Refund an order by returning to the shopper the desired amount.
Payment Methods
Refunds can only be executed for orders paid with either Cards, Google Pay or Apple Pay, Klarna, Paypal or Revolut Pay.
Full vs Partial
Refunds can be either full or partial. This is determined by the optional amount attribute. When omitted a full refund will be triggered. In any other case only the provided amount will be returned to the shopper.
Multiple partial refunds can be executed as long as the sum of the refunded amounts does not exceed order's total amount. Performing a partial refund and then requesting a full refund will result in an error.
Note: amount must be provided in cents. For example for returning 10€ to the shopper amount should be set to 1000
Order ID
order_id must be the order's ID in your own system (e.g. your PrestaShop, Magento,
WooCommerce, or Shopify order ID) — not Simpler's internal order ID. Simpler resolves the
order by looking up this ID against your merchant account.
Authentication
A POST request to https://merchant.simpler.so/api/v1/refunds requires basic authentication.
Your API key & Secret must be used for authorizing this request.
Request
Responses
- 200
- 202
- 400
- 401
- 403
- 404
- 422
- 500
Refund succeeded immediately.
Refund accepted but not yet completed — it has been queued for retry
(e.g. insufficient merchant balance) or requires manual processing.
No response body is returned. The final outcome is delivered
asynchronously via the REFUND_COMPLETED webhook.
Bad Request
Unauthorized
Forbidden
Not Found
The refund could not be processed for a business reason — the request itself is syntactically valid. This covers order-not-found, an already-active refund on the order, a validation failure (e.g. amount exceeds the refundable balance), and a terminal payment-provider failure.
Internal Server Error