{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"optional","examples":{"codes":[]},"method":"post","results":{"codes":[{"language":"text","code":""}]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Retrieve Card Info","type":"endpoint","slug":"retrieve-card-info","excerpt":"","body":"##Definition\nhttps<span>://sandbox.bluesnap.com/services/2/tools/credit-card-info-resolver\n\n<hr>\n\n##Documentation\nThis request enables you to verify the following details for a specific card number:\n  * Card type, such as Visa or Mastercard\n  * Card sub-type, such as credit or debit\n  * Card category, such as prepaid\n  * Bin category, such as commercial or consumer\n  * Card regulation, if eligible for US regulated debit pricing\n  * Issuing bank, the name of the bank that issued the card\n  * Issuing country code, such as US\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\n\nSend a **creditCard** object, with one of the following:\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`cardNumber` - first 6 digits only &nbsp;&nbsp;&nbsp;optional\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`encryptedCardNumber` *string* &nbsp;&nbsp;&nbsp;optional\n\n###JSON Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response includes the **creditCard** object, with the following properties:\n\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`cardType` *string*\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`cardSubType` *string*\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`cardCategory` *string* &nbsp;&nbsp;&nbsp;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`binCategory` *string* &nbsp;&nbsp;&nbsp;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`cardRegulated` *string* &nbsp;&nbsp;&nbsp;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`issuingBank` *string*\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`issuingCountryCode` *string*\n<br>\nIf the request fails, the API returns an HTTP 400 response, with one of these messages in the body:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"message\\\": [\\n  {\\n    \\\"errorName\\\": \\\"UNABLE_TO_RESOLVE_CARD_INFO\\\",\\n    \\\"code\\\": 22010,\\n    \\\"description\\\": \\\"Unable to resolve credit card info.\\\"\\n  }\\n ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Error: UNABLE_TO_RESOLVE_CARD_INFO\"\n    },\n    {\n      \"code\": \"{\\n  \\\"message\\\": [\\n  {\\n    \\\"errorName\\\": \\\"BIN_IS_NOT_VALID\\\",\\n    \\\"code\\\": 22011,\\n    \\\"description\\\": \\\"card number needs to be at least 6 digits long.\\\"\\n  }\\n ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Error: BIN_IS_NOT_VALID\"\n    },\n    {\n      \"code\": \"{\\n  \\\"message\\\": [\\n  {\\n    \\\"errorName\\\": \\\"MISSING_CARD_NUMBER\\\",\\n    \\\"code\\\": 22012,\\n    \\\"description\\\": \\\"Card number is missing.\\\"\\n  }\\n ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Error: MISSING_CARD_NUMBER\"\n    },\n    {\n      \"code\": \"{\\n  \\\"message\\\": [\\n  {\\n    \\\"errorName\\\": \\\"CARD_TYPE_NOT_SUPPORTED\\\",\\n    \\\"code\\\": 22013,\\n    \\\"description\\\": \\\"Card type is not supported.\\\"\\n  }\\n ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Error: CARD_TYPE_NOT_SUPPORTED\"\n    },\n    {\n      \"code\": \"{\\n  \\\"message\\\": [\\n  {\\n    \\\"errorName\\\": \\\"CARD_NUMBER_NOT_VALID\\\",\\n    \\\"code\\\": 22014,\\n    \\\"description\\\": \\\"Card number is not valid.\\\"\\n  }\\n ]\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Error: CARD_NUMBER_NOT_VALID\"\n    }\n  ]\n}\n[/block]\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/credit-card-info-resolver \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\\"cardNumber\\\": 422211}'\",\n      \"language\": \"curl\",\n      \"name\": \"Retrieve Card Info (plain card number - first 6 digits)\"\n    },\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/credit-card-info-resolver \\\\\\n-H 'Content-Type: application/json' \\\\\\n-H 'Accept: application/json' \\\\ \\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n{\\\"encryptedCardNumber\\\": \\\"$bsjs_0_0_1$cQfgKpL9FX462iFqeIpYbhL8xLIEYLeJuMRBQZw0UKUJGiuoXFeMoGqsgBlv0AM1olaSYk33bW4jNg69/mf/J/trRd0WsjU0+fkywvQAZqdt6RoMFW1YTT6bii02qy0TgLTPYHFEXL1Ei6sfft/QO6T9htKD4AAnS8E542Dc6bb90+qOZR2dmN3STCaefTudsO4mjUvX82lm0UzuO753OPNm1ICEB39zpwcL+oOd3mCRdnc9f9/Wt4AbLHGJY/ZD4RMnCBo1/ogRcTP19gquewauNnMAAeJ0h04kbDMXZGrDeAchFbLLyw+O7Nc96UN+PeoKrJWOGy/3urcWyhvaUA==$qQqzt+wBV+Ri4nEb0DUg5SRMmJDDN7A/7j4YK2GFzt2FP3N1ChG1dzTOLHd81dSd$pfpz7i+R2kLtJJIZUkhX1ARYEf4vakIF8qmYE777jas=\\\"}'\",\n      \"language\": \"curl\",\n      \"name\": \"Retrieve Card Info (encrypted card number)\"\n    }\n  ]\n}\n[/block]\n###Response Example\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"cardType\\\": \\\"VISA\\\",\\n    \\\"cardSubType\\\": \\\"CREDIT\\\",\\n    \\\"cardCategory\\\": \\\"BUSINESS\\\",\\n    \\\"binCategory\\\": \\\"COMMERCIAL\\\",\\n    \\\"cardRegulated\\\": \\\"N\\\",\\n    \\\"issuingBank\\\": \\\"BANCO BRADESCARD S.A.\\\",\\n    \\\"issuingCountryCode\\\": \\\"BR\\\"\\n}\\n\",\n      \"language\": \"json\",\n      \"name\": \"Retrieve Card Info Response: 200 OK\"\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\n`credit-card` *container* &nbsp;&nbsp;&nbsp;<span style=\"color:#F38A00\">**required**</span>, contains **one of** the following properties:\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`card-number` *string* - first 6 digits only &nbsp;&nbsp;&nbsp;optional\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`encrypted-card-number` *string* &nbsp;&nbsp;&nbsp;optional\n\n###XML Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response body includes the following:\n`credit-card` *container* &nbsp;&nbsp;&nbsp; with the following properties:\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`card-type` *string*\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`card-sub-type` *string*\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`card-category` *string* &nbsp;&nbsp;&nbsp;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`bin-category` *string* &nbsp;&nbsp;&nbsp;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`card-regulated` *string* &nbsp;&nbsp;&nbsp;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`issuing-bank` *string* &nbsp;&nbsp;&nbsp;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`issuing-country-code` *string*\n<br>\nIf the request fails, the API returns an HTTP 400 response, with one of these messages in the body:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<messages xmlns=\\\"http://ws.plimus.com\\\">\\n    <message>\\n        <error-name>UNABLE_TO_RESOLVE_CARD_INFO</error-name>\\n        <code>22010</code>\\n        <description>Unable to resolve credit card info.</description>\\n    </message>\\n</messages>\",\n      \"language\": \"xml\",\n      \"name\": \"Error: UNABLE_TO_RESOLVE_CARD_INFO\"\n    },\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<messages xmlns=\\\"http://ws.plimus.com\\\">\\n    <message>\\n        <error-name>BIN_IS_NOT_VALID</error-name>\\n        <code>22011</code>\\n        <description>card number needs to be at least 6 digits long.</description>\\n    </message>\\n</messages>\",\n      \"language\": \"xml\",\n      \"name\": \"Error: BIN_IS_NOT_VALID\"\n    },\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<messages xmlns=\\\"http://ws.plimus.com\\\">\\n    <message>\\n        <error-name>MISSING_CARD_NUMBER</error-name>\\n        <code>22012</code>\\n        <description>Card number is missing.</description>\\n    </message>\\n</messages>\",\n      \"language\": \"xml\",\n      \"name\": \"Error: MISSING_CARD_NUMBER\"\n    },\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<messages xmlns=\\\"http://ws.plimus.com\\\">\\n    <message>\\n        <error-name>CARD_TYPE_NOT_SUPPORTED</error-name>\\n        <code>22013</code>\\n        <description>Card type is not supported.</description>\\n    </message>\\n</messages>\",\n      \"language\": \"xml\",\n      \"name\": \"Error: CARD_TYPE_NOT_SUPPORTED\"\n    },\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<messages xmlns=\\\"http://ws.plimus.com\\\">\\n    <message>\\n        <error-name>CARD_NUMBER_NOT_VALID</error-name>\\n        <code>22014</code>\\n        <description>Card number is not valid.</description>\\n    </message>\\n</messages>\",\n      \"language\": \"xml\",\n      \"name\": \"Error: CARD_NUMBER_NOT_VALID\"\n    }\n  ]\n}\n[/block]\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/credit-card-info-resolver \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?>\\n<credit-card xmlns=\\\"http://ws.plimus.com\\\">\\n<card-number>422211</card-number>\\n</credit-card>\",\n      \"language\": \"curl\",\n      \"name\": \"Retrieve Card Info (plain card number - first 6 digits)\"\n    },\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/credit-card-info-resolver \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?>\\n<credit-card  xmlns=\\\"http://ws.plimus.com\\\">\\n    <encrypted-card-number>$bsjs_0_0_1$cQfgKpL9FX462iFqeIpYbhL8xLIEYLeJuMRBQZw0UKUJGiuoXFeMoGqsgBlv0AM1olaSYk33bW4jNg69/mf/J/trRd0WsjU0+fkywvQAZqdt6RoMFW1YTT6bii02qy0TgLTPYHFEXL1Ei6sfft/QO6T9htKD4AAnS8E542Dc6bb90+qOZR2dmN3STCaefTudsO4mjUvX82lm0UzuO753OPNm1ICEB39zpwcL+oOd3mCRdnc9f9/Wt4AbLHGJY/ZD4RMnCBo1/ogRcTP19gquewauNnMAAeJ0h04kbDMXZGrDeAchFbLLyw+O7Nc96UN+PeoKrJWOGy/3urcWyhvaUA==$qQqzt+wBV+Ri4nEb0DUg5SRMmJDDN7A/7j4YK2GFzt2FP3N1ChG1dzTOLHd81dSd$pfpz7i+R2kLtJJIZUkhX1ARYEf4vakIF8qmYE777jas=</encrypted-card-number>\\n</credit-card>'\",\n      \"language\": \"curl\",\n      \"name\": \"Retrieve Card Info (encrypted card number)\"\n    }\n  ]\n}\n[/block]\n###Response Example\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<credit-card xmlns=\\\"http://ws.plimus.com\\\">\\n    <card-type>VISA</card-type>\\n    <card-sub-type>CREDIT</card-sub-type>\\n    <card-category>BUSINESS</card-category>\\n    <bin-category>COMMERCIAL</bin-category>\\n    <card-regulated>N</card-regulated>\\n    <issuing-bank>BANCO BRADESCARD S.A.</issuing-bank>\\n    <issuing-country-code>BR</issuing-country-code>\\n</credit-card>\",\n      \"language\": \"xml\",\n      \"name\": \"Retrieve Card Info Response: 200 OK\"\n    }\n  ]\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \" </div>\\n</div>\"\n}\n[/block]","updates":["5b49b42e48ac4f0003210dd1"],"order":0,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5ecfffa62b00c0001886624c","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Retrieve Card Info","slug":"retrieving-card-info","order":9,"from_sync":false,"reference":true,"_id":"5ecfffa62b00c00018866223","version":"5ecfffa62b00c0001886626b","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2016-05-17T12:18:35.535Z","__v":0},"parentDoc":null,"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","version":{"version":"8976-Tools","version_clean":"8976.0.0-Tools","codename":"3.34.0 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ecfffa62b00c0001886621c","5ecfffa62b00c0001886621d","5ecfffa62b00c0001886621e","5ecfffa62b00c0001886621f","5ecfffa62b00c00018866220","5ecfffa62b00c00018866221","5ecfffa62b00c00018866222","5ecfffa62b00c00018866223","5ecfffa62b00c00018866224","5ecfffa62b00c00018866225","5ecfffa62b00c00018866226","5ecfffa62b00c00018866227","5b34c737e0dca2000311de6a","5ecfffa62b00c00018866228","5ecfffa62b00c00018866229","5ecfffa62b00c0001886622a"],"_id":"5ecfffa62b00c0001886626b","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5e5d3a6a50180a007203a5d0","createdAt":"2018-04-23T15:17:35.680Z","releaseDate":"2018-04-23T15:17:35.680Z"},"createdAt":"2016-05-17T13:14:52.652Z","githubsync":"","__v":1}

postRetrieve Card Info


Definition

https://sandbox.bluesnap.com/services/2/tools/credit-card-info-resolver


Documentation

This request enables you to verify the following details for a specific card number:

  • Card type, such as Visa or Mastercard
  • Card sub-type, such as credit or debit
  • Card category, such as prepaid
  • Bin category, such as commercial or consumer
  • Card regulation, if eligible for US regulated debit pricing
  • Issuing bank, the name of the bank that issued the card
  • Issuing country code, such as US