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:

PropertyTypeRequired
paymentMethodNamestringrequired
currencyCodestringrequired
countryCodestringrequired

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:

PropertyTypeRequired
payment-method-namestringrequired
currency-codestringrequired
country-codestringrequired

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>