Retrieve Bank Details

This request gets a list of available banks for the iDEAL payment method, allowing you to show a list of banks in the UI so your shopper can make their selection.

Try it in the API Explorer

JSON
XML

JSON Request Content

Send a bankDirectory object, with the following:
     paymentMethodName     string    required
     currencyCode     string    required
     countryCode     string    required

JSON Response Details

If successful, the response HTTP status code is 200 OK.
The response contains the retrieved bankDirectory object (see bankDirectory (JSON object)).

JSON Examples

Request Examples

curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/bank-directory-info \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
  "currencyCode": "EUR",
  "countryCode": "NL",
  "paymentMethodName": "IDEAL"
}'

Response Examples

{
  "issuersInfo": [
    {
      "issuerId": "RABONL2U",
      "issuerName": "Issuer Simulation V3 - RABO"
    },
    {
      "issuerId": "INGBNL2A",
      "issuerName": "Issuer Simulation V3 - ING"
    }
  ]
}

XML Request Content

Send a bank-directory resource, with the following:
     payment-method-name     string    required
     currency-code     string    required
     country-code     string    required

XML Response Details

If successful, the response HTTP status code is 200 OK.
The response contains the retrieved bank-directory resource (see bank-directory (XML resource)).

XML Examples

Request Examples

curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/bank-directory-info \
-H 'Content-Type: application/xml' \
-H 'Accept: application/xml' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<bank-directory xmlns="http://ws.plimus.com">
  <currency-code>EUR</currency-code>
  <country-code>NL</country-code>
  <payment-method-name>IDEAL</payment-method-name>
</bank-directory>'

Response Examples

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bank-directory xmlns="http://ws.plimus.com">
  <issuers-info>
    <issuer-id>RABONL2U</issuer-id>
    <issuer-name>Issuer Simulation V3 - RABO</issuer-name>
  </issuers-info>
  <issuers-info>
    <issuer-id>INGBNL2A</issuer-id>
    <issuer-name>Issuer Simulation V3 - ING</issuer-name>
  </issuers-info>
</bank-directory>

API Explorer (JSON)

To test out a call, enter the request content below and then click Try it!. You can use the JSON code below as a starting point. The request headers, including authorization, are already built-in for you in this test area.

{
  "currencyCode": "EUR",
  "countryCode": "nl",
  "paymentMethodName": "IDEAL"
}