iDEAL
Overview
The iDEAL integration offered by Trustly allows for both iDEAL and Trustly payments on a single integration with all transactions visible in the same AccountLedger.
Please talk to your Trustly account manager if you want to have iDEAL enabled on your Trustly account.
To initiate a new iDEAL payment, add "Method":"deposit.bank.netherlands.ideal"
to the Deposit attributes.
All other attributes should remain the same as in a regular Deposit call.
Code example
{
"method":"Deposit",
"params":{
"UUID":"54401111-1800-898f-bbff-bc6667c93a47",
"Data":{
"Attributes":{
"Country": "NL",
"Locale":"en_NL",
"Lastname":"Svensson",
"Firstname":"Sven",
"Email": "test@trustly.com",
"Method":"deposit.bank.netherlands.ideal",
"Amount":"10",
"Currency":"EUR",
"FailURL":"https://yourpage.com/fail",
"SuccessURL":"https://yourpage.com/success"
},
"Username":"username",
"Password":"password",
"NotificationURL": "https://your\_notification\_page/123",
"EndUserID":"test",
"MessageID":"111111"
},
"Signature":"n2r4eJ2....yp8YTxhdg=="
},
"version":"1.1"
}
iDeal notifications
All notifications for iDEAL are the same as for a regular Trustly Deposit: credit, debit, cancel and pending. It is also possible to use account notification together with iDEAL. If you would like to use account notification, please contact our Integration team.
iDEAL refunds
iDEAL orders can be refunded by using the Refund method, just like a regular Trustly Deposit.
iDEAL checkout
Certain rules apply for the iDEAL checkout: iDEAL and Trustly should be shown as two separate options in the merchants checkout, where choosing iDEAL will redirect client to the Trustly iDEAL checkout, and choosing Trustly - to the regular Trustly checkout.
You can download the iDEAL logo here.
The iDEAL flow is typically:
Payment is initiated. The Trustly iDEAL checkout is shown with the option to start the payment process. Merchants also have an option to skip that screen in which users are automatically redirected to the next step.
The client is redirected to iDEAL for payment processing:
The client completes the payment through iDEAL.
iDEAL test cases
To test various scenarios, the iDEAL test environment offers a simulation checkout page with selectable options. These options include different bank response outcomes and response delays. Some of the available bank response options are:
Succeeded
Pending
Failed User Abort
Failed Timeout
You can also simulate different delays in the bank's response with these options:
No delay
30 seconds after submission
1 minute after submission
5 minutes after submission
15 minutes after submission
1 hour after submission