credit-card

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

Request

Property NameTypeRequiredDescription
card-last-four-digitsstringOptional
Required if sending a vaulted-shopper-id and the vaulted shopper has multiple saved credit cards.
Last four digits of the credit card.
card-numberstringRequired 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
card-typestringOptional 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
encrypted-card-numberstringRequired if card-number is not sent.

Optional if sending a vaulted-shopper-id.
Encrypted credit card number.
encrypted-security-codestringOptional
Relevant if security-code is not sent.
N/A for batch transactions
Encrypted credit card security code.
expiration-monthstringRequired
Optional if sending a vaulted-shopper-id
Credit card expiration month.
expiration-yearstringRequired
Optional if sending a vaulted-shopper-id
Credit card expiration 4-digit year.
security-codestringOptional
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-tokenstringOptional
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
bin-categorystringIndicates whether the card is used for business expenses (Commercial) or personal expenses (Consumer).
bin-numberstringThe 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-categorystringCard category, such as business or prepaid. \nAppears only if relevant.
card-last-four-digitsstringLast four digits of the credit card.
card-regulatedstringIndicates whether the card is regulated.
Values: Y N
card-sub-typestringCard sub-type, such as Credit or Debit
card-typestringCredit card type.
expiration-monthintegerCredit card expiration month.
Appears only in responses for Create and Retrieve Vaulted Shopper.
expiration-yearintegerCredit card expiration 4-digit year.
Appears only in responses for Create and Retrieve Vaulted Shopper.
issuing-bankstringThe bank that issued the shopper's card.
issuing-country-codestringCountry code of the shopper's issuing bank.