📘
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
Schemas used in requests/responses of our API:
| Parameter | Type | Description | Constraints | Required |
|---|
| success | String(1...2000) | Return URL to use when the transaction succeeds. | | ✅ |
| cancelled | String(1...2000) | Return URL to use when the transaction is cancelled. | | ✅ |
| expired | String(1...2000) | Return URL to use when the transaction is expired. | | ✅ |
| failed | String(1...2000) | Return URL to use when the transaction is failed. | | ✅ |
| Parameter | Type | Description | Constraints | Required |
|---|
| redirect | redirect Object | Next action to be performed by merchant (or consumer) to complete the payment. | | |
| Parameter | Type | Description | Constraints | Required |
|---|
| url | String | URL where consumer should be redirected to by the merchant to perform the payment. | | |
| Parameter | Type | Description | Constraints | Required |
|---|
| name | String | Customer name. | | |
| bic | String(8...11) | Bank Identification Code used by the customer. | | |
| iban | String | IBAN used by the customer. | | |
| checkoutDetails | Object | Contains the optional Fast Checkout details requested during the transaction creation. | | |
| Parameter | Type | Description | Constraints | Required |
|---|
| contactDetails | Object | Contact details of the consumer | Available if requested | |
| shippingAddress | Object | Shipping Address of the consumer | Available if requested | |
| invoiceAddress | Object | Invoice Address of the consumer | Available if requested | |
| Parameter | Type | Description | Constraints | Required |
|---|
| firstName | String | The first name of the consumer as configured in their Currence profile | Available if requested | |
| lastName | String | The last name of the consumer as configured in their Currence profile | Available if requested | |
| phoneNumber | String | The phone number of the consumer as configured in their Currence profile | Available if requested | |
| email | String | The email of the consumer as configured in their Currence profile | Available if requested | |
| Parameter | Type | Description | Constraints | Required |
|---|
| firstName | String | The first name of the consumer as configured in their Currence profile | Available if requested | |
| lastName | String | The last name of the consumer as configured in their Currence profile | Available if requested | |
| companyName | String | The company name of the consumer as configured in their Currence profile | Available if requested | |
| postalCode | String | The postal code of the consumer as configured in their Currence profile | Available if requested | |
| houseNumber | String | The house number of the consumer as configured in their Currence profile | Available if requested | |
| addition | String | Addition to the house number of the consumer as configured in their Currence profile | Available if requested | |
| street | String | The street of the consumer as configured in their Currence profile | Available if requested | |
| city | String | The city of the consumer as configured in their Currence profile | Available if requested | |
| countryName | String | The countryName of the consumer as configured in their Currence profile | Available if requested | |
| Parameter | Type | Description | Constraints | Required |
|---|
| refundedAmount | Int(0...99999999) | Amount in the smallest currency subunit, as for example eurocents, that has already been refunded. | | ✅ |
| refundedPendingAmount | Int(1...99999999) | Amount in the smallest currency subunit, as for example eurocents, that has been requested to be refunded. | | ✅ |
