Retrieve Card Info

Definition

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


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

JSON

JSON Request Content

Send a creditCard object, with one of the following:

  • cardNumber - first 6 digits only    optional
  • encryptedCardNumber string    optional

JSON Response Details

If successful, the response HTTP status code is 200 OK. The response includes the creditCard object, with the following properties:

Property

Type

cardType

string

cardSubType

string

cardCategory

string

binCategory

string

cardRegulated

string

issuingBank

string

issuingCountryCode

string

If the request fails, the API returns an HTTP 400 response, with one of these messages in the body:

{
  "message": [
  {
    "errorName": "UNABLE_TO_RESOLVE_CARD_INFO",
    "code": 22010,
    "description": "Unable to resolve credit card info."
  }
 ]
}
{
  "message": [
  {
    "errorName": "BIN_IS_NOT_VALID",
    "code": 22011,
    "description": "card number needs to be at least 6 digits long."
  }
 ]
}
{
  "message": [
  {
    "errorName": "MISSING_CARD_NUMBER",
    "code": 22012,
    "description": "Card number is missing."
  }
 ]
}
{
  "message": [
  {
    "errorName": "CARD_TYPE_NOT_SUPPORTED",
    "code": 22013,
    "description": "Card type is not supported."
  }
 ]
}
{
  "message": [
  {
    "errorName": "CARD_NUMBER_NOT_VALID",
    "code": 22014,
    "description": "Card number is not valid."
  }
 ]
}

JSON Examples

Request Examples

curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/credit-card-info-resolver \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{"cardNumber": 422211}'
curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/credit-card-info-resolver \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{"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="}'

Response Example

{
    "cardType": "VISA",
    "cardSubType": "CREDIT",
    "cardCategory": "BUSINESS",
    "binCategory": "COMMERCIAL",
    "cardRegulated": "N",
    "issuingBank": "BANCO BRADESCARD S.A.",
    "issuingCountryCode": "BR"
}

XML

XML Request Content

credit-card container    required, contains one of the following properties:

  • card-number string - first 6 digits only    optional
  • encrypted-card-number string    optional

XML Response Details

If successful, the response HTTP status code is 200 OK. The response body includes the following: credit-card container     with the following properties:

Property

Type

card-type

string

card-sub-type

string

card-category

string

bin-category

string

card-regulated

string

issuing-bank

string

issuing-country-code

string

If the request fails, the API returns an HTTP 400 response, with one of these messages in the body:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages xmlns="http://ws.plimus.com">
    <message>
        <error-name>UNABLE_TO_RESOLVE_CARD_INFO</error-name>
        <code>22010</code>
        <description>Unable to resolve credit card info.</description>
    </message>
</messages>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages xmlns="http://ws.plimus.com">
    <message>
        <error-name>BIN_IS_NOT_VALID</error-name>
        <code>22011</code>
        <description>card number needs to be at least 6 digits long.</description>
    </message>
</messages>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages xmlns="http://ws.plimus.com">
    <message>
        <error-name>MISSING_CARD_NUMBER</error-name>
        <code>22012</code>
        <description>Card number is missing.</description>
    </message>
</messages>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages xmlns="http://ws.plimus.com">
    <message>
        <error-name>CARD_TYPE_NOT_SUPPORTED</error-name>
        <code>22013</code>
        <description>Card type is not supported.</description>
    </message>
</messages>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages xmlns="http://ws.plimus.com">
    <message>
        <error-name>CARD_NUMBER_NOT_VALID</error-name>
        <code>22014</code>
        <description>Card number is not valid.</description>
    </message>
</messages>

XML Examples

Request Examples

curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/credit-card-info-resolver \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<?xml version="1.0" encoding="UTF-8"?>
<credit-card xmlns="http://ws.plimus.com">
<card-number>422211</card-number>
</credit-card>
curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/credit-card-info-resolver \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<?xml version="1.0" encoding="UTF-8"?>
<credit-card  xmlns="http://ws.plimus.com">
    <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>
</credit-card>'

Response Example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<credit-card xmlns="http://ws.plimus.com">
    <card-type>VISA</card-type>
    <card-sub-type>CREDIT</card-sub-type>
    <card-category>BUSINESS</card-category>
    <bin-category>COMMERCIAL</bin-category>
    <card-regulated>N</card-regulated>
    <issuing-bank>BANCO BRADESCARD S.A.</issuing-bank>
    <issuing-country-code>BR</issuing-country-code>
</credit-card>