{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/tools/bank-directory-info","auth":"optional","settings":"57ee593a21ceb20e0061959e","results":{"codes":[]},"params":[],"examples":{"codes":[]},"method":"post"},"next":{"description":"","pages":[]},"title":"Retrieve Bank Details","type":"endpoint","slug":"get-bank-details","excerpt":"","body":"This request gets a list of available banks for the [iDEAL](/docs/ideal) payment method, allowing you to show a list of banks in the UI so your shopper can make their selection. \n\n \n<span></span>\n<a class=\"btn btn-success\" href=\"#section-api-explorer-json-\" role=\"button\">Try it in the API Explorer</a>\n<br>\n[block:html]\n{\n \"html\": \"<ul class=\\\"nav nav-pills nav-justified\\\">\\n <li class=\\\"active\\\"><a data-toggle=\\\"pill\\\" href=\\\"#menujson\\\">JSON</a></li>\\n <li><a data-toggle=\\\"tab\\\" href=\\\"#menuxml\\\">XML</a></li>\\n</ul>\\n<div class=\\\"tab-content\\\">\\n <div id=\\\"menujson\\\" class=\\\"tab-pane fade in active\\\">\"\n}\n[/block]\n###JSON Request Content \nSend a **[bankDirectory](/v8976-Tools/docs/bankdirectory-json-object)** object, with the following:\n `paymentMethodName` *string* <span style=\"color:#F37500\">**required**</span> \n `currencyCode` *string* <span style=\"color:#F37500\">**required**</span>\n `countryCode` *string* <span style=\"color:#F37500\">**required**</span> \n\n###JSON Response Details \nIf successful, the response HTTP status code is 200 OK.\nThe response contains the retrieved `bankDirectory` object (see [bankDirectory (JSON object)](doc:bankdirectory-json-object)). \n\n<hr>\n\n##JSON Examples\n\n###Request Examples\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/bank-directory-info \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\n \\\"currencyCode\\\": \\\"EUR\\\",\\n \\\"countryCode\\\": \\\"NL\\\",\\n \\\"paymentMethodName\\\": \\\"IDEAL\\\"\\n}'\",\n \"language\": \"curl\",\n \"name\": \"Get Bank Details: for iDEAL\"\n }\n ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"issuersInfo\\\": [\\n {\\n \\\"issuerId\\\": \\\"RABONL2U\\\",\\n \\\"issuerName\\\": \\\"Issuer Simulation V3 - RABO\\\"\\n },\\n {\\n \\\"issuerId\\\": \\\"INGBNL2A\\\",\\n \\\"issuerName\\\": \\\"Issuer Simulation V3 - ING\\\"\\n }\\n ]\\n}\",\n \"language\": \"json\",\n \"name\": \"iDEAL\"\n }\n ]\n}\n[/block]\n\n[block:html]\n{\n \"html\": \" </div>\\n <div id=\\\"menuxml\\\" class=\\\"tab-pane fade\\\">\"\n}\n[/block]\n###XML Request Content \nSend a **[bank-directory](doc:bank-directory-xml-resource)** resource, with the following:\n `payment-method-name` *string* <span style=\"color:#F37500\">**required**</span> \n `currency-code` *string* <span style=\"color:#F37500\">**required**</span>\n `country-code` *string* <span style=\"color:#F37500\">**required**</span> \n\n###XML Response Details \nIf successful, the response HTTP status code is 200 OK.\nThe response contains the retrieved `bank-directory` resource (see [bank-directory (XML resource)](doc:bank-directory-xml-resource)). \n\n<hr>\n\n##XML Examples\n\n###Request Examples\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/bank-directory-info \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Accept: application/xml' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<bank-directory xmlns=\\\"http://ws.plimus.com\\\">\\n <currency-code>EUR</currency-code>\\n <country-code>NL</country-code>\\n <payment-method-name>IDEAL</payment-method-name>\\n</bank-directory>'\",\n \"language\": \"curl\",\n \"name\": \"Get Bank Details: for iDEAL\"\n }\n ]\n}\n[/block]\n##Response Examples \n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<bank-directory xmlns=\\\"http://ws.plimus.com\\\">\\n <issuers-info>\\n <issuer-id>RABONL2U</issuer-id>\\n <issuer-name>Issuer Simulation V3 - RABO</issuer-name>\\n </issuers-info>\\n <issuers-info>\\n <issuer-id>INGBNL2A</issuer-id>\\n <issuer-name>Issuer Simulation V3 - ING</issuer-name>\\n </issuers-info>\\n</bank-directory>\",\n \"language\": \"xml\",\n \"name\": \"iDEAL\"\n }\n ]\n}\n[/block]\n\n[block:html]\n{\n \"html\": \"</div>\\n</div>\"\n}\n[/block]\n\n##API Explorer (JSON)\nTo 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.\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"currencyCode\\\": \\\"EUR\\\",\\n \\\"countryCode\\\": \\\"nl\\\",\\n \\\"paymentMethodName\\\": \\\"IDEAL\\\"\\n}\",\n \"language\": \"json\"\n }\n ]\n}\n[/block]","updates":[],"order":0,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5fa1893ed2a2370028d24273","createdAt":"2020-08-31T16:53:50.564Z","user":"5ea72d649148ff00653f6bbc","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Bank Directory","slug":"bank-directory","order":5,"from_sync":false,"reference":false,"_id":"5fa1893ed2a2370028d2422e","createdAt":"2020-08-31T16:53:05.091Z","version":"5fa1893ed2a2370028d24282","project":"57336fd5a6a9c40e00e13a0b","__v":0},"version":{"version":"8976-Tools","version_clean":"8976.0.0-Tools","codename":"3.36 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5fa1893ed2a2370028d2421e","5fa1893ed2a2370028d2421f","5fa1893ed2a2370028d24220","5fa1893ed2a2370028d24221","5fa1893ed2a2370028d24222","5fa1893ed2a2370028d24223","5fa1893ed2a2370028d24224","5fa1893ed2a2370028d24225","5fa1893ed2a2370028d24226","5fa1893ed2a2370028d24227","5fa1893ed2a2370028d24228","5fa1893ed2a2370028d24229","5b34c737e0dca2000311de6a","5fa1893ed2a2370028d2422a","5fa1893ed2a2370028d2422b","5fa1893ed2a2370028d2422c","5fa1893ed2a2370028d2422d","5fa1893ed2a2370028d2422e","5fa1893ed2a2370028d2422f","5fa18956dd369d003cb51fc6"],"_id":"5fa1893ed2a2370028d24282","project":"57336fd5a6a9c40e00e13a0b","__v":1,"forked_from":"5f4d276c4ff932005f3e3b86","createdAt":"2018-04-23T15:17:35.680Z","releaseDate":"2018-04-23T15:17:35.680Z"},"project":"57336fd5a6a9c40e00e13a0b","__v":0,"parentDoc":null}postRetrieve Bank Details
Definition
{{ api_url }}{{ page_api_url }}
Documentation
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.
{
"currencyCode": "EUR",
"countryCode": "nl",
"paymentMethodName": "IDEAL"
}
