Transmitting buyer details
The buyer’s details (e-mail address, title, telephone number, etc.) are used as billing details.
All the transmitted details are displayed in the transaction details (Buyer tab) in the Merchant Back Office.
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.: abc@example.com |
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 | enum | PRIVATE: for private clients COMPANY: for companies |
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 | ans..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="https://scelliuspaiement.labanquepostale.fr/vads-payment/"> <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="smith.john@example.com" /> <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="7896adcaf7338930db9715afa123531f42"/> <input type="submit" name="pay" value="Pay"/> </form>