Transmitting buyer details
The Merchant can specify the buyer details (e-mail address, title/civil status, 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 (Client 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.: 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://secure.lyra.com/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>