Create a Refund
iDEAL becomes Wero
You’ll soon see a new logo: iDEAL | Wero.
iDEAL is evolving into "Wero", a new pan-European payment solution by the European Payments Initiative (EPI). The first step is the introduction of the mandatory iDEAL-Wero co-branding on all existing iDEAL checkout pages.
CM.com is handling all the technical updates required for iDEAL's transition to Wero, ensuring a seamless process for merchants. There will be no changes to the implementation of the current iDEAL payment method, so merchants can continue using it as usual without any disruptions.
To comply with the new guidelines, you have between January 29, 2026 and March 31, 2026 to complete the following:
- Change the payment method name from iDEAL to iDEAL | Wero
- Update the iDEAL logo to the iDEAL Wero co-branded logo. For instructions and the graphic files: https://ideal.nl/ideal-wero-branding
You can use this call to create a refund for a payment made with an iDEAL transaction.
Request
POST https://api.pay.cm.com/api/v1/paymentmethods/ideal/v1/transactions/{transactionId}/refunds
{
"amount": 1200,
"reason": "Refund required by customer."
}
Optional parameters
| Parameter | Type | Description | Constraints |
|---|---|---|---|
| amount | Int(1...99999999) | Denomination in the smallest currency subunit (e.g. eurocents). If empty, the refund amount will be the remaining available amount of the transaction (e.g. total payment amount minus already refunded amounts minus the amounts of the pending refund requests). | Must be lower than or equal to the original transaction amount. |
| reason | String(255) | The description for the refund. |
Response
If refund has been successfully created then the response is the Get Transaction response with an updated refunds.refundedAmount and refunds.refundedPendingAmount.
Response codes
| HTTP status | Description |
|---|---|
| 201 | Refund successfully created. |
| 4XX | Client error response (See message for details). This response is given when the User input was incorrect or something illegal was attempted (eg. using a service without having that service configured for the user, or not being authorized). |
| 5XX | Server error response (See message for details). |
Updated 16 days ago