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

Request Content

Send a bankDirectory object, with the following:

PropertyTypeRequired
paymentMethodNamestringrequired
currencyCodestringrequired
countryCodestringrequired

Response Details

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

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:

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

Response Details

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

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>