open menu
axerve docs
Payments/Alternative payments/iDEAL



When using iDEAL payment method, an additional step is required to the buyer before being sent to the third-party processor: to choose their bank from a list of participating banks.

Merchants can embed this step in their websites, in order to manage the payment method choice and provide their buyers with the same experience of direct connections to the third party processors.

This can be done through a feature called “Payment Type Detail”.

Merchants are free to use this option or not: if they do not use it and they simply set <paymentType>S2PIDE</paymentType> in their call to Encrypt method of WsCryptDecrypt web service, then the buyer will find in Axerve Ecommerce Solutions a page where it will choose its bank among those available for that kind of payment.

Merchants who want to use “Payment Type Detail” for iDEAL, must be able to show to their buyers the list of the banks available for that kind of payment.

They can store the list of those banks in their local storage and keep it updated by periodically calling the methodsCallIdealListS2S of WsS2S web service.

These methods will return a list of banks in the following way:

2  <Bank>
3    <BankCode>Code0001</BankCode>
4    <BankName>Name of Bank 1</BankName> 
5  </Bank>
6  ... 
7  <Bank>
8    <BankCode>Code0000N</BankCode>
9    <BankName>Name of Bank N</BankName> 
10  </Bank>

Since the list of the banks partecipating to iDEAL is not changing very quickly, a weekly update is suggested.

The update should consist of a complete replacement of each list with the new values returned by WsS2S web service.

The merchant page should show the list of the BankNames and use the corresponding BankCode.

The BankCode must be used for paymentTypeDetail tag, while calling the Encrypt method of WsCryptDecrypt web service, as a value for IdealBankCode, depending on the payment method. For example, for an iDEAL transaction for which the buyer has chosen “Name of Bank X”, the merchant should call encrypt method with, among the others, these values:

3  <paymentType>S2PIDE</paymentType> 
6  <IdealBankCode>Code0000Y</IdealBankCode>

IDeal Credential Test Environment

You can try to use iDEAL in test environment using low amount like 10.00 EUR.

When landing of iDEAL payment page, select the bank you prefer in the middle page and then follow the instruction in order to have a successful test payment.

The maximum payable amount by a customer, for iDEAL, is:




IDEAL banks list 

To retrieve the iDEAL Bank List the correct WSs2s web service method to use for this purpose is callIdealListS2Sapi link.

However, before using this method, it is necessary to assign to callIdealListS2S the field:

  • shopLogin (merchant code)

The callIdealListS2S method retrieves from Axerve Ecommerce Solutions the iDEAL Bank List.

After the method is performed, it is possible to know the outcome of the operation by reading the relevant fields:

  • First it is possible to use the TransactionResult method which will return the string OK if the check has been performed or the string KO if not.

  • ErrorCode Returns error code

  • ErrorDescription Returns error description

  • BankList Returns a list of banks split into Bank nodes. Each Bank node has two elements:

    • BankCode Returns the Bank Code

    • BankName Returns the Bank Name

prevGoogle Pay™