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 can offer frictionless authentication.
See the list below:
| 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 Address line 2 | 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 alpha-2 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 Address line 2 | 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 alpha-2 standard | Format: String | Maximum length: 255 Example: FR |
| customer.shippingDetails.shippingMethod Shipping mode. | Format: String | Maximum length: 24 Example: RECLAIM_IN_SHOP |
| customer.shippingDetails.shippingSpeed Shipping delay. | Format: String | Maximum length: 8 Example: EXPRESS |