Objects Card
The card object represents the card details having the sensitive information masked. The card object appears within the transaction object as a part of the card transaction notification.
{danger.fa-exclamation-triangle} IMPORTANT #1: Card data from the
cardobject can be stored by the merchants and does not require the PCI DSS compliance from the merchant. The tokenized card format does not have any restrictions, except for the general privacy and confidentiality principles.
{danger.fa-exclamation-triangle} IMPORTANT #2: When a card transaction is initiated within cashier using a new card, CRM notification will include “card_token” value - “b00e3dac57e9b2d5ec7b6783f36119bc” which is a placeholder, customer will not see it in a dropdown of saved payment details, and you will not be able to use it for direct/card-token API 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"
}