Contains the details for a specific credit card, such as the card number and expiration date
Request
| Property Name | Type | Required | Description |
|---|---|---|---|
cardLastFourDigits | string | Optional Required if sending a vaulted shopper ID and the shopper has multiple saved credit cards. | Last four digits of the credit card. |
cardNumber | string | Required if encryptedCardNumber is not sent.Optional if sending a vaulted shopper ID. | Credit card number. Maximum 21 characters. For example: 4111111111111111 4111-1111-1111-1111 * 4111 1111 1111 1111 |
cardType | string | Optional if sending cardNumber or encryptedCardNumber.Note: If BlueSnap identifies that the card type is different than what you send, the transaction will fail. If you do not send the cardType, BlueSnap will automatically identify the type based on the number. You can check the card type for a specific number using the Retrieve Card Info request.Required if sending a vaulted shopper ID and the shopper has multiple saved credit cards. | Credit card type. Possible Values: AMEXARGENCARDCABALCARTE_BLEUECENCOSUDCHINA_UNION_PAYDANKORTDINERSDISCOVERELOHIPERCARDJCBMAESTR_UKMASTERCARDNARANJASOLOTARJETASHOPPINGVISA |
encryptedCardNumber | string | Required if cardNumber is not sent.Optional if sending a vaulted shopper ID. | Encrypted credit card number. |
encryptedSecurityCode | string | Optional Relevant if securityCode is not sent.N/A for batch transactions | Encrypted credit card security code. |
expirationMonth | string | Required Optional if sending a vaulted shopper ID. | Credit card expiration month. |
expirationYear | string | Required Optional if sending a vaulted shopper ID. | Credit card expiration 4-digit year. |
securityCode | string | Optional Relevant if encryptedSecurityCode 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. |
securityCodePfToken | 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 |
|---|---|---|
binCategory | string | Indicates whether the card is used for business expenses (Commercial) or personal expenses (Consumer). |
binNumber | 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. |
cardCategory | string | Card category, such as business or prepaid. Appears only if relevant. |
cardLastFourDigits | string | Last four digits of the credit card. |
cardRegulated | string | Indicates whether the card is regulated. Values: Y N |
cardSubType | string | Card sub-type, such as Credit or Debit |
cardType | string | Credit card type. |
expirationMonth | string | Credit card expiration month. Appears only in responses for Create and Retrieve Vaulted Shopper. |
expirationYear | string | Credit card expiration 4-digit year. Appears only in responses for Create and Retrieve Vaulted Shopper. |
issuingBank | string | The bank that issued the shopper's card. |
issuingCountryCode | string | Country code of the shopper's issuing bank. |
