credit-card

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

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

encrypted-card-number

string

Required if card-number is not sent.

Optional if sending a vaulted-shopper-id.

Encrypted credit card number.

encrypted-security-code

string

Optional
Relevant if security-code is not sent.
N/A for batch transactions

Encrypted credit card security code.

expiration-month

string

Required
Optional if sending a vaulted-shopper-id

Credit card expiration month.

expiration-year

string

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.

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.

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-category

string

Card category, such as business or prepaid. Appears only if relevant.

card-last-four-digits

string

Last four digits of the credit card.

card-regulated

string

Indicates whether the card is regulated.
Values: Y or N

card-sub-type

string

Card sub-type, such as Credit or Debit

card-type

string

Credit card type.

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.

issuing-bank

string

The bank that issued the shopper's card.

issuing-country-code

string

Country code of the shopper's issuing bank.