Transmitting buyer details
The Merchant can specify the buyer’s billing details (e-mail address, title, phone number, etc.). This information will be used to create the invoice.
All the data transmitted via the payment form can be viewed in the transaction details in the Merchant Back Office (Buyer tab).
| Field name | Description | Value |
|---|---|---|
Hosted Payment Page : vads_cust_email REST API : customer.email | Buyer’s e-mail address | E.g.: name@example.com |
Hosted Payment Page : vads_cust_id REST API : customer.reference | Buyer reference on the merchant website | E.g.: C2383333540 |
Hosted Payment Page : vads_cust_title REST API : customer.billingDetails.title | Buyer’s title | E.g.: Mister |
Hosted Payment Page : vads_cust_status REST API : customer.billingDetails.category | Status | PRIVATE: for private clients COMPANY: for companies |
Hosted Payment Page : vads_cust_first_name REST API : customer.billingDetails.firstName | First name | E.g.: Laurent |
Hosted Payment Page : vads_cust_last_name REST API : customer.billingDetails.lastName | Last name | E.g.: Durant |
Hosted Payment Page : vads_cust_legal_name REST API : customer.billingDetails.legalName | Buyer’s legal name | E.g.: D. & Cie |
Hosted Payment Page : vads_cust_cell_phone REST API : customer.billingDetails.cellPhoneNumber | Cell phone number | E.g.: 06 12 34 56 78 |
Hosted Payment Page : vads_cust_address_number REST API : customer.billingDetails.streetNumber | Street number | E.g.: 109 |
Hosted Payment Page : vads_cust_address REST API : customer.billingDetails.address | Postal address | E.g.: Rue de l'Innovation |
Hosted Payment Page : vads_cust_address2 REST API : customer.billingDetails.address2 | Address line 2 | E.g.: |
Hosted Payment Page : vads_cust_district REST API : customer.billingDetails.district | District | E.g.: Centre ville |
Hosted Payment Page : vads_cust_zip REST API : customer.billingDetails.zipcode | Zip code | E.g.: 31670 |
Hosted Payment Page : vads_cust_city REST API : customer.billingDetails.city | City | E.g.: Labège |
Hosted Payment Page : vads_cust_state REST API : customer.billingDetails.state | State / Region | E.g.: Occitanie |
Hosted Payment Page : vads_cust_country REST API : customer.billingDetails.country | Country code in compliance with the ISO 3166 alpha-2 standard. Must be transmitted in order to trigger one or several actions depending on the buyer’s country. | E.g.: "FR" for France, "PF" for French Polynesia, "NC" for New Caledonia, "US" for the United States. |
Note
vads_cust_phone and vads_cust_cell_phone fields accept all formats:
- 0123456789
- +33123456789
- 0033123456789
- (00.571) 638.14.00
- 40 41 42 42