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

  1. Use the fields required for your use case (see chapter Generating a payment form ) to create your payment form.
  2. Use optional fields according to your requirements. These fields will be returned in 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_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 Name ans..63 E.g.: Durant
    vads_cust_legal_name Buyer’s legal name an..100 E.g.: D. & Cie
    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 Second line of the address ans..255 E.g.:
    vads_cust_district District ans..127 E.g.: Downtown
    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 standard a2

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

  3. Compute the value of the signature field using all the fields of your form that start with vads_ (see chapter Computing the signature).
  4. Compute the value of the signature field using all the fields of your form that start with vads_ (see chapter Computing the signature).

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="20140327133115" />
<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"/>