credit-card

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

Request

Property NameTypeRequiredDescription
card-numberstring
  • *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-numberstring
  • *Required** 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-monthinteger

Required

Optional if sending a vaulted-shopper-id

Credit card expiration month.
expiration-yearinteger

Required

Optional if sending a vaulted-shopper-id

Credit card expiration 4-digit year.
security-codestring

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

Optional

Relevant if security-code is not sent.

N/A for batch transactions

Encrypted credit card security code.
security-code-pf-tokenstring

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

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

Credit card expiration month.

Appears only in responses for Create and Retrieve Vaulted Shopper.

expiration-yearinteger

Credit card expiration 4-digit year.

Appears only in responses for Create and Retrieve Vaulted Shopper.