credit-card

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

Request

Property NameTypeRequiredDescription
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
encrypted-card-numberstringRequired if card-number is not sent.

Optional if sending a vaulted-shopper-id.
Encrypted credit card number.
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-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
expiration-monthintegerRequired

Optional if sending a vaulted-shopper-id
Credit card expiration month.
expiration-yearintegerRequired

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.
encrypted-security-codestringOptional

Relevant if security-code is not sent.

N/A for batch transactions
Encrypted credit card security code.
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
card-last-four-digitsstringLast four digits of the credit card.
card-typestringCredit card type.
card-sub-typestringCard sub-type, such as Credit or Debit
card-categorystringCard category, such as business or prepaid.
Appears only if relevant.
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-regulatedstringIndicates whether the card is regulated.

Values:
Y
N
issuing-bankstringThe bank that issued the shopper's card.
issuing-country-codestringCountry code of the shopper's issuing bank.
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.