Credit Card Attributes

This object defines an instance of a specific Credit Card.

Name	Type	Description
object	string	Value is “CreditCard”
vid	string	A Globally Unique Identifier (GUID) for this object. This field is created by Subscribe.
account	string	The Primary Account Number (PAN) aka Credit Card Number (encrypted/hidden when returned) For non-Subscribe methods (e.g., Transaction::score), this field must be left blank. The precise form used here will vary with the exact payment method.
bin	string	The first 6 digits of the PAN (Bank Identifier Number). If the account field is provided, this may be left blank and it will be filled in by Vindicia.
type	string	Issuing card network information. enum: [AX,CU,DC,DD,DI,JC,MC,MD,SW,VI]
last_digits	string	The last 4 digits of the PAN
account_length	integer	The number of digits in the PAN
hash_type	enum	The algorithm used for hashing the account number. If this value is not provided we assume SHA1. Values can be `sha1`, `md5`
account_hash	string	A hash of the full PAN. Any non-numeric characters should be removed prior to hashing. If the account number is provided, this may be left blank and the hash will be calculated by Vindicia. The exact length and format of this string may depend upon the hash algorithm chosen.
expiration_date	string	Expiration date of the credit card. Should be formatted as YYYYMM. For example, July, 2028 should be sent as 202807.
extended_card_attributes	Extended Card Attributes	Additional credit card details returned from Payment Provider
extended_verification	Extended Verification	Input Details for ExtendedVerification of a credit card payment method.
extended_verification_response	Extended Verification Response	Defines the Payment Provider’s response to a 3DS authentication request.
cvn	string	CVV (Card Verification Value) or CVN (Card Verification Number) printed on the card.
last_au_request_date	datetime	Timestamp of the most recent Account Updater request.
last_update_date	datetime	Timestamp of the most recent credit card update.
au_response_code	string	Response code from the payment provider for the most recent Account Updater request.
au_response_message	string	Reply from the payment provider for the most recent Account Updater request.

{
  "object" : "PaymentMethod",
  "id" : "pm_1234",
  "vid" : "ad427a35c0335f61ee639c6b614eca1c89337eac",
  "active" : true,
  "description" : "Personal Visa",
  "currency" : "EUR",
  "primary" : true,
  "type" : "credit_card",
  "credit_card" : {
    "account" : "4111111111111111",
    "expiration_date" : "202501",
    "cvn" : "123"
  },
  "metadata" : {
    "favorite activity" : "flying kites",
    "favorite dog" : "Snoopy"
  }
}

Parent topic:Credit Cards

Home

Guides

APIs