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 Expert Back Office (Buyer tab).

Field name Description Value

Hosted Payment Page: vads_cust_email


Buyer’s e-mail address


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


PRIVATE: for private clients COMPANY: for companies

Hosted Payment Page: vads_cust_first_name

REST API: customer.billingDetails.firstName

First name E.g.: John

Hosted Payment Page: vads_cust_last_name

REST API: customer.billingDetails.lastName

Name E.g.: Smith

Hosted Payment Page: vads_cust_legal_name


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

Second line of the address E.g.:

Hosted Payment Page: vads_cust_district

REST API: customer.billingDetails.district

District E.g.: Downtown

Hosted Payment Page: vads_cust_zip

REST API: customer.billingDetails.zipcode

Zip code E.g.: 31670

Hosted Payment Page: vads_cust_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


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


vads_cust_phone and vads_cust_cell_phone fields accept all formats:

  • 0123456789
  • +33123456789
  • 0033123456789
  • (00.571) 638.14.00
  • 40 41 42 42