Contains the details for a specific credit card, such as the card number and expiration date
Request
| Property Name | Type | Required | Description |
|---|---|---|---|
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 |
encryptedCardNumber | string | Required if cardNumber is not sent.Optional if sending a vaulted shopper ID. | Encrypted credit card number. |
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. |
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 |
expirationMonth | integer | Required Optional if sending a vaulted shopper ID. | Credit card expiration month. |
expirationYear | integer | 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. |
encryptedSecurityCode | string | Optional Relevant if securityCode is not sent.N/A for batch transactions | Encrypted credit card security code. |
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 |
|---|---|---|
cardLastFourDigits | string | Last four digits of the credit card. |
cardType | string | Credit card type. |
cardSubType | string | Card sub-type, such as Credit or Debit |
cardCategory | string | Card category, such as business or prepaid. Appears only if relevant. |
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. |
cardRegulated | string | Indicates whether the card is regulated. Values: Y N |
issuingBank | string | The bank that issued the shopper's card. |
issuingCountryCode | string | Country code of the shopper's issuing bank. |
expirationMonth | integer | Credit card expiration month. Appears only in responses for Create and Retrieve Vaulted Shopper. |
expirationyear | integer | Credit card expiration 4-digit year. Appears only in responses for Create and Retrieve Vaulted Shopper. |
