Transmitting buyer details
Buyer details (e-mail address, title, phone number, etc.) constitute billing information.
All transmitted data is displayed in the transaction details (tab Buyer) 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 | 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://sogecommerce.societegenerale.eu/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="rEFhNTLXQ4o6BgbW1pTMoM2yMilw90OIqmFjJ6DeCxP="/> <input type="submit" name="pay" value="Pay"/> </form>