Field | Description | Mandatory | Type | Example | Condition |
title | Title of civility | No | AN1 | See the table of values | |
lastName | Buyer's surname | No | AN100 | ||
firstName | Buyer's first name | No | AN100 | ||
Buyer's email address | No | AN150 | Do not put more than 12 consecutive digits (eg test123456789101@test.test ) | ||
shippingAdress | Delivery address. | No | |||
billingAddress | Billing address | No | Object Address | ||
accountCreateDate | The date of creation of the buyer's account. Format : dd/mm/yy | No | AN10 | 01/04/16 | |
accountAverageAmount | The average amount of this buyer's purchases | No | N10 | ||
accountOrderCount | The number of orders placed by this buyer | No | N10 | ||
walletId | The virtual wallet identifier of your client. | No | AN50 | Mandatory for wallet payment | |
walletDisplayed | Management of the display of the means of payment of your customer. To not display the customer payment data, enter the value "none". To display the customer payment data, the tag must be empty or absent. | No | AN5 | ||
walletSecured | Nature of the control added to the payment kinematics WEB. | No | AN12 | See the table of values | |
walletCardInd | Specifies the index of the map to use. | No | AN2 | 1 | The index of the map, default value "1" |
ip | Buyer's IP address. Format : IPv4 or IPv6 | No | AN50 | ||
mobilePhone | The mobile number of the buyer | No | N15 | 0033691666666 | |
customerId | Customer ID | No | AN50 | 894492568 | Clearsale: This data can be an identifier or an email |
legalStatus | Legal status of the customer: person or company | No | N1 | 1 | Clearsale: see the table of value. |
legalDocument | Identification number of the official document | No | AN100 | X5446119U | |
birthDate | Birth date. Format: yyyy-mm-dd | No | AN10 | 2016-04-27 | |
fingerprintID | ID Device fingerprint | No | AN50 | ||
deviceFingerprint | DeviceFingerPrint information. | No | AN | from version 15 | |
isBot | DeviceFingerPrint information. Possible value: Y or N | No | AN1 | from version 15 | |
isIncognito | DeviceFingerPrint information. Possible value: Y or N | No | AN1 | from version 15 | |
isBehindProxy | DeviceFingerPrint information. Possible value: Y or N | No | AN1 | from version 15 | |
isFromTor | DeviceFingerPrint information. Possible value: Y or N | No | AN1 | from version 15 | |
isEmulator | DeviceFingerPrint information. Possible value: Y or N | No | AN1 | from version 15 | |
isRooted | DeviceFingerPrint information. Possible value: Y or N | No | AN1 | from version 15 | |
hasTimezoneMismatch | DeviceFingerPrint information. Possible value: Y or N | No | AN1 | from version 15 | |
loyaltyMemberType | No | AN | from version 21 or higher (3DSV2) RELEASE 4.58 | ||
buyerExtended | Past events about buyer | No | AN | { "loyaltyMemberId" : "buyerExtLoyMemId" , "buyerExtendedHistory" : {...} } | from version 21 or higher (3DSV2) RELEASE 4.58 |
merchantAuthentication | Information about cardholder to authenticate to the merchant | No | Object - merchantAuthentication | from version 21 or higher (3DSV2) RELEASE 4.58 |
buyerExtendedHistory with JSON format :
{
"suspiciousActivity"
:
"Y"
,
"firstOrderDate"
:
"2018-01-01"
,
"lastOrderDate"
:
"2018-09-09"
,
"totalAmount"
:
"200"
,
"totalCurrency"
:
"978"
,
"lastChange"
:
"2018-02-02"
,
"lastPasswordChange"
:
"2018-03-03"
,
"provisionAttempsDay"
:
"10"
,
"paymentAccountAge"
:
"11"
,
"orderCount6Months"
:
"10"
,
"orderAmount6Months"
:
"10"
,
"transactionCountDay"
:
"10"
,
"transactionCountYear"
:
"10"
}
Field | Description | Mandatory | Type | Condition | Example | |
suspiciousActivity | Indicates whether the merchant has experienced suspicious activity (including previous fraud) on the cardholder account : 01 : No suspicious | No | AN2 | 3DSV2 | 01 | |
firstOrderDate | Date of the first order for this buyer | No | 07/12/2018 10:40 | |||
lastOrderDate | Date of the last order for the buyer (excluding the current order) | No | 07/12/2018 10:40 | |||
totalAmount | Total amount of the orders placed by the buyer | No | 200 | |||
totalCurrency | Currency of the orders | No | 978 | |||
lastChange | Date of the last change on the buyer account | No | AN16 | 3DSV2 | 07/12/2018 10:40 | |
lastPasswordChange | Date of the last password change | No | AN16 | 3DSV2 | 07/12/2018 10:40 | |
provisionAttemptsDay | Number of Provisioning Attempts Day Number of Add Card attempts in the last 24 hours | No | N3 | 3DSV2 | 1 | |
paymentAccountAge | Payment Account Age Date that the payment account was enrolled in the cardholder’s account with the merchant Date format = DD/MM/YYYY | No | AN10 | 3DSV2 | 14/11/2018 | |
orderCount6Months | Number of orders placed by the buyer during the last 6 months | No | N4 | 3DSV2 | 15 | |
orderAmount6Months | Total amount of the orders placed by the buyer during the last 6 months | No | ||||
transactionCountDay | Total amount of the orders placed by the buyer during the last 365 days | No | N3 | 3DSV2 | 0 | |
transactionCountYear | Number of orders placed by the buyer during the last 365 days | No | N3 | 3DSV2 | 38 |