Contains the details for a specific credit card, such as the card number and expiration date
Request
| Property Name | Type | Required | Description |
|---|---|---|---|
card-last-four-digits | string | Optional Required if sending a vaulted-shopper-id and the vaulted shopper has multiple saved credit cards. | Last four digits of the credit card. |
card-number | string | Required if encrypted-card-number is not sent.Optional if sending a vaulted-shopper-id. | Credit card number. Maximum 21 characters. For example: 41111111111111114111-1111-1111-11114111 1111 1111 1111 |
card-type | string | Optional if sending card-number or encrypted-card-number. Note: If you do not send the card-type, BlueSnap will automatically identify the type based on the number. If you do send a card type but BlueSnap identifies that the card is a different type, the transaction will fail. You can check the card type for a specific number using the Retrieve Card Info request. Required if sending a vaulted-shopper-id and card-last-four-digits | Credit card type.Possible Values:
|
encrypted-card-number | string | Required if card-number is not sent. Optional if sending a vaulted-shopper-id. | Encrypted credit card number. |
encrypted-security-code | string | Optional Relevant if security-code is not sent.N/A for batch transactions | Encrypted credit card security code. |
expiration-month | string | Required Optional if sending a vaulted-shopper-id | Credit card expiration month. |
expiration-year | string | Required Optional if sending a vaulted-shopper-id | Credit card expiration 4-digit year. |
security-code | string | Optional Relevant if encrypted-security-code is not sent.N/A for batch transactions | Credit card security code. Should be 4 characters for American Express or 3 characters for any other card type. |
security-code-pf-token | string | Optional Relevant if using Hosted Payment Fields | Hosted Payment Fields token that has been associated with a shopper's CVV. Useful for verifying CVV when shopper uses a saved card. |
Response
| Property Name | Type | Description |
|---|---|---|
bin-category | string | Indicates whether the card is used for business expenses (Commercial) or personal expenses (Consumer). |
bin-number | string | The Bank Identification Number (BIN) on the customer's payment card. This is the first 4 to 6 digits of the credit card number and is used to identify the institution that issued the card. |
card-category | string | Card category, such as business or prepaid. Appears only if relevant. |
card-last-four-digits | string | Last four digits of the credit card. |
card-regulated | string | Indicates whether the card is regulated. Values: Y or N |
card-sub-type | string | Card sub-type, such as Credit or Debit |
card-type | string | Credit card type. |
expiration-month | integer | Credit card expiration month. Appears only in responses for Create and Retrieve Vaulted Shopper. |
expiration-year | integer | Credit card expiration 4-digit year. Appears only in responses for Create and Retrieve Vaulted Shopper. |
issuing-bank | string | The bank that issued the shopper's card. |
issuing-country-code | string | Country code of the shopper's issuing bank. |