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).

Use optional fields according to your requirements. These fields will be returned with the response and will include the value transmitted in the form.
Field name Description Format Value
vads_cust_email Buyer’s e-mail address ans..150 E.g.:
vads_cust_id Buyer reference on the merchant website an..63 E.g.: C2383333540
vads_cust_national_id National identifier ans..255 E.g.: 940992310285
vads_cust_title Buyer’s title an..63 E.g.: M
vads_cust_status Status


PRIVATE: for a private individual

COMPANY: for a company

vads_cust_first_name First name ans..63 E.g.: Laurent
vads_cust_last_name Last name ans..63 E.g.: Durant
vads_cust_legal_name Buyer’s legal name an..100 E.g.: D. & Cie
vads_cust_phone Phone number an..32 E.g.: 0467330222
vads_cust_cell_phone Cell phone number an..32 E.g.: 06 12 34 56 78
vads_cust_address_number Street number ans..64 E.g.: 109
vads_cust_address Postal address ans..255 E.g.: Rue de l'Innovation

vads_cust_address2 Address line 2 ans..255 E.g.:
vads_cust_district District ans..127 E.g.: Centre ville
vads_cust_zip Zip code an..64 E.g.: 31670
vads_cust_city City an..128 E.g.: Labège
vads_cust_state State / Region ans..127 E.g.: Occitanie
vads_cust_country Country code in compliance with the ISO 3166 alpha-2 standard a2

E.g.: "FR" for France, "PF" for French Polynesia, "NC" for New Caledonia, "US" for the United States.

Example of payment form with buyer details:
<form method="POST" action="">
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<input type="hidden" name="vads_amount" value="4000" />
<input type="hidden" name="vads_capture_delay" value="0" />
<input type="hidden" name="vads_ctx_mode" value="PRODUCTION" />
<input type="hidden" name="vads_currency" value="978" />
<input type="hidden" name="vads_cust_country" value="FR" />
<input type="hidden" name="vads_cust_email" value="" />
<input type="hidden" name="vads_cust_first_name" value="John" />
<input type="hidden" name="vads_cust_last_name" value="Smith" />
<input type="hidden" name="vads_cust_title" value="Mr" />
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_config" value="SINGLE" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20190627133115" />
<input type="hidden" name="vads_trans_id" value="522754" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="rEFhNTLXQ4o6BgbW1pTMoM2yMilw90OIqmFjJ6DeCxP="/>
<input type="submit" name="pay" value="Pay"/>