Fields allowing to improve the chances of frictionless
In order to allow the card issuer to determine the risk of a transaction, it is recommended to transmit as much information as possible upon payment.
The more information issuers have about the cardholders’ habits, the more they will be able to offer frictionless authentication.
The list below is not definitive and can be extended.
| Name/Description | Format/Values |
|---|---|
| customer.email Buyer’s e-mail address | Format: String | Maximum length: 150 E.g.: sample@example.com |
| customer.billingDetails.identityCode National identifier. Allows to identify each citizen within a country. | Format: String | Maximum length: 150 |
| customer.billingDetails.streetNumber Street number of the billing address | Format: String | Maximum length: 5 |
| customer.billingDetails.address Postal address | Format: String | Maximum length: 255 |
| customer.billingDetails.address2 Second line of the address | Format: String | Maximum length: 255 |
| customer.billingDetails.zipCode Zip code | Format: String | Maximum length: 64 |
| customer.billingDetails.city City | Format: String | Maximum length: 128 |
| customer.billingDetails.state State / Region | Format: String | Maximum length: 127 |
| customer.billingDetails.country Country code in compliance with the ISO 3166 standard | Format: String | Maximum length: 2 Example: ES |
| customer.billingDetails.phoneNumber Shipping buyer’s phone number | Format: String | Maximum length: 32 |
| customer.billingDetails.cellPhoneNumber Cell phone number | Format: String | Maximum length: 32 |
| customer.shippingDetails.address Postal address | Format: String | Maximum length: 255 |
| customer.shippingDetails.address2 Second line of the address | Format: String | Maximum length: 255 |
| customer.shippingDetails.zipCode Zip code | Format: String | Maximum length: 64 |
| customer.shippingDetails.city City | Format: String | Maximum length: 128 |
| customer.shippingDetails.state State / Region | Format: String | Maximum length: 127 |
| customer.shippingDetails.country Country code in compliance with the ISO 3166 standard | Format: String | Maximum length: 255 Example: FR |
| customer.shippingDetails.shippingMethod Shipping mode. New values specific to 3DS2 will be available soon. | Format: String | Maximum length: 24 Example: RECLAIM_IN_SHOP |
| customer.shippingDetails.shippingSpeed Shipping delay. New values specific to 3DS2 will be available soon. | Format: String | Maximum length: 8 Example: EXPRESS |