account

string

The credit card’s account number. Be certain to enter the number in full if you are using the associated payment method for CashBox one-time or recurring Transactions. When fully specified, this number must fulfill the Luhn check criterion. 

Note CashBox partially masks the account number (for example, 444444XXXXXX1111) when returning this object to you in response to a call.

If this object is associated with a Transaction object that is reported directly to Vindicia (for example, if you are a ChargeGuard customer and report Transactions you process outside of CashBox), you might choose to omit this value or mask it partially for security. In that case, specify one of the following:

• An encrypted value of the credit-card account number in the accountHash field (see the item below), or
• The BIN (the first six digits of the credit-card number) and the last four digits of that number in the bin and lastDigits fields (see the items below).

accountLength

int

The length (number of digits) of the full account number. For example, for a Visa credit card, set the value to 16. Specify this string only if you are not specifying the full account number for security reasons.

bin

string

The BIN, which is the first six digits of the full account number. Specify this string only if you are not specifying the full account number or its hash in the accountHash field for security when reporting transactions to Vindicia for ChargeGuard. You need not specify this field if the associated payment method is for a Transaction processed through CashBox.

extendedCardAttributes

ExtendedCardAttributes

Enhanced auth response details returned from Payment Provider.

See the ExtendedCardAttributes Subobject.

expirationDate

string

The CreditCard expiration date in YYYYMM format, where YYYY is the four-digit year and MM is the two-digit month. For example, the string for July 2007 is 200707.

hashType

HashType

The type of hash algorithm used if you specify the accountHash field. The allowed value is sha1, as CashBox only supports SHA1 hashing. Do not specify this field if the associated payment method is for a one-time or recurring Transaction processed through CashBox, as CashBox will automatically default to SHA1.

lastDigits

string

The truncated last part of the full credit-card account number, typically the last four or five digits of that number. Specify this string only if you are notspecifying the full account number or its hash in the accountHash field for security when reporting transactions to Vindicia for ChargeGuard.

VID

string

Vindicia's Globally Unique Identifier (GUID) for this object. When creating a new CreditCard object, leave this field blank; it will be automatically populated by CashBox.