Create a refund
Refunds the full amount or part of a completed order. A refund is a new order, linked to the original order through refund_of_order_id. It always uses the currency of the original order. To refund the full remaining amount, send an empty JSON object {} as the body: the body is required, the amount isn't.
You can refund an order several times, as long as the total doesn't exceed the amount paid. For a pre-authorization, that's the captured amount. See Refunds.
apiKeyAuthorizationBasic <token>Use your project's API key as the username and leave the password empty. Only use the API key from your server: it gives full access to your project.
order_id*stringThe id of the order.
uuidapplication/json- body
amount?AmountAmount to refund in the smallest currency unit. Without it, the full remaining amount of the order is refunded. Send {} as the body in that case, a request without a body is refused.
0 <= valuedescription?stringDescription of the refund. Without it, the description of the original order is used.
order_lines?array<>The order lines to refund, for an order created with order_lines.
The refund has been created. The response contains the refund order.
application/json- response
id*stringOrder ID.
uuidproject_id*stringID of the project the order belongs to.
uuidmerchant_id*stringID of your merchant account.
uuidmerchant_order_id?stringYour own order reference, shown in the merchant portal. Recommended.
description?stringDescription of the order. Recommended.
currency*CurrencyISO 4217 currency code, such as EUR, GBP or USD. Get supported currencies lists the currencies of your project.
^[A-Z]{3}$amount*AmountAmount in the smallest currency unit, including VAT. 1234 is € 12.34. For currencies without minor units, send the whole amount.
0 <= valuestatus*stringStatus of the order. completed, cancelled, expired and error are final. See Order statuses.
"new""processing""completed""cancelled""expired""error"flags?array<string>Labels of the order, such as is-test for orders in a test project and is-refund for refund orders.
created*TimestampDate and time in ISO 8601 format.
date-timemodified*TimestampDate and time in ISO 8601 format.
date-timecompleted?TimestampDate and time in ISO 8601 format.
date-timelast_transaction_added?stringWhen the latest transaction was added to the order.
date-timeexpiration_period?DurationHow long the order stays valid, such as PT1H for one hour.
capture_mode?stringMakes every transaction of the order a pre-authorization. Without it, the amount is captured right away. A capture_mode on a transaction overrides it.
manual: the amount is reserved until you capture or void it.delayed: the amount is captured automatically when theexpiration_periodends.
"manual""delayed"payment_methods?array<|>The payment methods to show on the hosted payment page. Without it, every payment method that's active in your project is shown.
transactions?array<>The payment attempts of the order. When you create the order, send one transaction to pick the payment method yourself. Without it, your customer picks a payment method on the hosted payment page.
order_url?stringThe hosted payment page of the order. Redirect your customer here when you didn't send a transaction.
urireturn_url?stringWhere your customer goes after the payment, or after 3-D Secure authentication in your own checkout. Without it, your customer stays on the Rabobank result page. Recommended.
urifailure_url?stringWhere your customer goes when the payment fails, with status cancelled, expired or error. Without it, your customer goes to the return_url.
uriwebhook_url?stringWhere webhooks for this order are sent. Overrides the webhook URL of your project.
uricustomer?Your customer. Card schemes use these details for 3-D Secure risk assessment, so complete details lead to more frictionless payments. Your acquirer can require some of them.
order_lines?array<>The items of the order. Optional for card payments.
client?The software that sends the request, such as your e-commerce platform or plugin.
extra?Your own data to store with the order. It's returned when you retrieve the order.
merchant_tags?Key-value tags copied from your merchant account when the order was created.
events?array<>Log of what happened to the order. See Transaction events for the events of each transaction.
refunded_amount?integerThe amount refunded on this order so far, in the smallest currency unit.
refund_of_order_id?stringFor a refund order, the ID of the original order.
uuidrefund_orders?array<>IDs of the refund orders of this order.
capture_of_order_id?stringFor a capture order, the ID of the original order.
uuidvoid_of_order_id?stringFor a void order, the ID of the original order.
uuidchargeback_of_order_id?stringFor a chargeback order, the ID of the original order.
uuidchargeback_orders?array<>IDs of the chargeback orders of this order.
reversal_of_order_id?stringFor a reversal order, the ID of the original order.
uuidreversal_orders?array<>IDs of the reversal orders of this order.
related_payment_link_id?stringID of the payment link the order was created from.
uuidcurl -X POST 'https://api.prod.smartpay.gingerpayments.com/v1/orders/8078d78f-8700-4cfe-94b1-4a777d3400f2/refunds/' \ --user "$API_KEY:" \ -H 'Content-Type: application/json' \ -d '{ "amount": 1337, "description": "Example refund"}'{ "id": "97e825b2-c77d-4d56-aeaf-7af9c7c4087f", "project_id": "05ad138f-52fa-40dc-9751-5fde949dcb57", "merchant_id": "b251b220-5d8b-4b9d-9915-b89676dc0948", "created": "2026-10-12T11:48:59.630958+00:00", "completed": "2026-10-12T11:48:59.912726+00:00", "currency": "EUR", "amount": 1337, "description": "Example refund", "flags": [ "is-refund", "is-test" ], "refund_of_order_id": "8189619d-748e-4333-81ee-fca65b1f47bc", "status": "completed", "transactions": [ { "id": "8deb1542-fbe7-442e-9510-ea7c819e3bea", "order_id": "97e825b2-c77d-4d56-aeaf-7af9c7c4087f", "amount": 1337, "currency": "EUR", "credit_debit": "debit", "payment_method": "credit-card-refund", "payment_method_brand": "mastercard", "refund_of_transaction_id": "6fbaeb49-6c55-408b-82ac-1b410db9fe1c", "status": "accepted" } ]}