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.

JSON

JSON Request Content

Send a bankDirectory object, with the following:

Property

Type

Required

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

XML Request Content

Send a bank-directory resource, with the following:

Property

Type

Required

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>