Skip to main content

iDEAL

Features
MethodAsync - GET Redirect
CountriesNetherlands
Processing currenciesEUR
Increments-
Captures-
Partial/Multiple partial captures-
Cancels-
Partial/Multiple partial cancels-
Refunds
Partial/Multiple partial refunds
Recurring-
Installments-
Credits-
Disputes-
Min Amount0.01
Account verification-

iDEAL is an online payment method that allows consumers to pay via their own bank. Not only web shops but also other companies offer iDEAL. iDEAL is a direct online transfer from customer bank account to a merchant's bank account.

When a consumer shops online using the iDEAL payment method, the merchant sends a payment to the PSP.

The merchant redirects to the iDEAL page and allows the customer to select his bank and complete the purchase.

Payment flow

iDEAL payment flow

Payment

Request

{
"processingAccountId": "2HdN2jq6XWmlkhqRC2gDTNYCvNH",
"merchantReference": "c5211d6b-0178-49f8-a06b-69df097a712f",
"amount": {
"value": 200,
"currency": "eur"
},
"paymentMethod": {
"type": "ideal",
"ideal": {
"returnUrl": "https://merchant.site/complete-payment",
"consumer": {
"name": "John Doe",
}
}
}
}

Response

{
"id": "27yiW9MgzBtwiodreuNOXk0rtIw",
"merchantReference": "c5211d6b-0178-49f8-a06b-69df097a712f",
"status": "pending",
"trackingUrl": "/v1/tracks/payments/{trackId}",
"reason": {
"code": "required_next_step",
"description": "An additional step is needed to complete the payment."
},
"nextStep": {
"type": "redirect",
"redirect": {
"method": "get",
"url": "https://payment.method/complete"
}
}
}