{"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":"603fec227146110018e1da93","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":"603fec227146110018e1da4d","createdAt":"2020-08-31T16:53:05.091Z","version":"603fec227146110018e1daaf","project":"57336fd5a6a9c40e00e13a0b","__v":0},"version":{"version":"8976-Tools","version_clean":"8976.0.0-Tools","codename":"3.37 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["603fec227146110018e1da3d","603fec227146110018e1da3e","603fec227146110018e1da3f","603fec227146110018e1da40","603fec227146110018e1da41","603fec227146110018e1da42","603fec227146110018e1da43","603fec227146110018e1da44","603fec227146110018e1da45","603fec227146110018e1da46","603fec227146110018e1da47","603fec227146110018e1da48","5b34c737e0dca2000311de6a","603fec227146110018e1da49","603fec227146110018e1da4a","603fec227146110018e1da4b","603fec227146110018e1da4c","603fec227146110018e1da4d","603fec227146110018e1da4e","603fec227146110018e1da4f"],"_id":"603fec227146110018e1daaf","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"6019bc72944282005e966fd4","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"
}