Objects Card
The card object represents card details with sensitive information masked. It appears within the transaction object as part of the card transaction notification.
{danger.fa-exclamation-triangle} IMPORTANT 1:
Card data from thecardobject can be stored by merchants and does not require PCI DSS compliance.
This tokenized card format is not subject to restrictions—aside from general privacy and confidentiality principles.
{danger.fa-exclamation-triangle} IMPORTANT 2:
When a card transaction is initiated via Cashier using a new card, the CRM notification will include acard_tokenvalue such as:
"b00e3dac57e9b2d5ec7b6783f36119bc"(this is a placeholder).
The customer will not see this token in their list of saved payment methods, and you will not be able to use it fordirect/card-tokenAPI calls.
STRUCTURE
✓ - required value
? - optional, value or null
✕ - always appears as null
| Variable | Type | Description | |
|---|---|---|---|
| card_token | varchar(32) | ? | HASH value of customer's card. Will not be passed in case the transaction is declined and there are no previously approved credit card transactions with the same card for the user. |
| card_type | varchar(10) | ? | Customer card type (AMEX, DinersClub, Discover, Electron, JCB, Maestro, MasterCard, Mir, VISA) |
| card_number | varchar(19) | ✓ | Customer card number (4444 44** **** 1233) |
| card_exp | varchar(8) | ? | Customer card exp (10/2023) |
| card_issuer_name | varchar(255) | ? | Customer card issuing bank name |
| card_issuer_country | varchar(2) | ? | Customer card issuing bank country |
| card_holder | varchar(255) | ? | The cardholder name field will be sent to the CRM in the notification only if the setting in the Atlas BO is enabled. Otherwise, the key will not be sent at all (not 0 / null / empty string). |
| card_funding_source | varchar(32) | ? | Funding source (DEBIT, CREDIT). This parameter including in the request by enabling an additional setting on Atlas BO. |
| card_subtype | varchar(32) | ? | The card category subtype is CONSUMER or COMMERCIAL. This parameter is included in the request when an additional setting is enabled in the Atlas BO. |
EXAMPLE
{
"card_token": "J-4-a0vPhjZ9R75JP98VDUFgbh9y8sYr",
"card_type": "VISA",
"card_number": "411111******1111",
"card_exp": "12\/2024",
"card_issuer_name": "Random Bank, London",
"card_issuer_country": "GB",
"card_holder": "John Johnson",
"card_funding_source": "DEBIT",
"card_subtype": "CONSUMER"
}