creditCard

Contains the details for a specific credit card, such as the card number and expiration date

Request

Property NameTypeRequiredDescription
cardNumberstringRequired 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
encryptedCardNumberstringRequired if cardNumber is not sent.

Optional if sending a vaulted shopper ID.
Encrypted credit card number.
cardLastFourDigitsstringOptional

Required if sending a vaulted shopper ID and the shopper has multiple saved credit cards.
Last four digits of the credit card.
cardTypestringOptional 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:
AMEX
ARGENCARD
CABAL
CARTE_BLEUE
CENCOSUD
CHINA_UNION_PAY
DANKORT
DINERS
DISCOVER
ELO
HIPERCARD
JCB
MAESTR_UK
MASTERCARD
NARANJA
SOLO
TARJETASHOPPING
VISA
expirationMonthintegerRequired

Optional if sending a vaulted shopper ID.
Credit card expiration month.
expirationYearintegerRequired

Optional if sending a vaulted shopper ID.
Credit card expiration 4-digit year.
securityCodestringOptional

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.
encryptedSecurityCodestringOptional

Relevant if securityCode is not sent.

N/A for batch transactions
Encrypted credit card security code.
securityCodePfTokenstringOptional

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 NameTypeDescription
cardLastFourDigitsstringLast four digits of the credit card.
cardTypestringCredit card type.
cardSubTypestringCard sub-type, such as Credit or Debit
cardCategorystringCard category, such as business or prepaid.
Appears only if relevant.
binCategorystringIndicates whether the card is used for business expenses (Commercial) or personal expenses (Consumer).
binNumberstringThe 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.
cardRegulatedstringIndicates whether the card is regulated.

Values:
Y
N
issuingBankstringThe bank that issued the shopper's card.
issuingCountryCodestringCountry code of the shopper's issuing bank.
expirationMonthintegerCredit card expiration month.

Appears only in responses for Create and Retrieve Vaulted Shopper.
expirationyearintegerCredit card expiration 4-digit year.

Appears only in responses for Create and Retrieve Vaulted Shopper.