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.