Request Options

The options service retrieves a list of bank option IDs and bank names which you can display to the customer on your web site.

Request the options service once each day, at any time, to retrieve the list of bank names. Each name represents the bank identification code (BIC, also known as a

swift code

) associated with the bank and is prefixed with

ideal

, for example: ideal-BUNQNL2A.

Cybersource

recommends caching the information and displaying the bank name to the customer in a drop-down menu on your checkout page. The customer chooses the iDEAL payment method and chooses their bank from the list of options that you have cached.

A list of all available banks can be displayed in a drop-down menu in any order you choose.

Cybersource

recommends displaying the following six bank names and their logos at the top of the list:

When a customer chooses a bank on your web site, you must include the associated option ID in the sale request (see Processing a Sale). This returns a bank redirect URL, which steers the customer to the bank they have chosen. If the option ID is not included in the sale request, the bank redirect URL directs the customer to a bank selection page.

Set the

apOptionsService_run

field to

true

, and send the request to one of these endpoints:

Production:

https://ics2ws.ic3.com/commerce/1.x/transactionProcessor

Test:

https://ics2wstest.ic3.com/commerce/1.x/transactionProcessor