credit-card

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

Request

Property Name	Type	Required	Description
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: 4111111111111111 4111-1111-1111-1111 4111 1111 1111 1111
encrypted-card-number	string	*Required** if card-number is not sent. Optional if sending a vaulted-shopper-id.	Encrypted credit card number.
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-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**: AMEX ARGENCARD CABAL CARTE_BLEUE CENCOSUD CHINA_UNION_PAY DANKORT DINERS DISCOVER ELO HIPERCARD JCB MAESTR_UK MASTERCARD NARANJA SOLO TARJETASHOPPING VISA
expiration-month	integer	Required Optional if sending a vaulted-shopper-id	Credit card expiration month.
expiration-year	integer	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.
encrypted-security-code	string	Optional Relevant if security-code is not sent. N/A for batch transactions	Encrypted credit card security code.
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
card-last-four-digits	string	Last four digits of the credit card.
card-type	string	Credit card type.
card-sub-type	string	Card sub-type, such as Credit or Debit
card-category	string	Card category, such as business or prepaid. Appears only if relevant.
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-regulated	string	Indicates whether the card is regulated. Values: Y N
issuing-bank	string	The bank that issued the shopper's card.
issuing-country-code	string	Country code of the shopper's issuing bank.
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.