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.

Credit card number. For example:

  • 4111111111111111
  • 4111-1111-1111-1111
  • 4111 1111 1111 1111

encrypted-card-number

string

Required if card-number is not sent.

Encrypted credit card number.

card-last-four-digits

string

Optional

Required if sending shopper-id and the shopper has multiple saved cards.

Last four digits of the credit card.

card-type

string

Optional if sending card-number or encrypted-card-number

Required if sending shopper-id and the shopper has multiple saved cards.

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.

Credit card type.

expiration-month

integer

Required

Credit card expiration month.

expiration-year

integer

Required

Credit card expiration 4-digit year.

security-code

string

Required if encrypted-security-code is not sent.

Credit card security code.

encrypted-security-code

string

Required if security-code is not sent.

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

expiration-month

integer

Credit card expiration month. Appears only in responses for Retrieve Shopper.

expiration-year

integer

Credit card expiration 4-digit year. Appears only in responses for Retrieve Shopper.

issue-number

string

Issue number on the credit card.