Transmitting shipping details

The merchant can transmit the buyer's shipping details (e-mail address, civil status, phone number, etc.).

These data will be visible in the Back Office by consulting the transaction details (Shipping tab).

  1. Use the fields required for your use case (see chapter Generating a payment form) to create your payment form
  2. Use the optional fields presented below according to your requirements.These fields will be sent back with the response and will include the value transmitted in the form.
    Table 1. Field list - Shipping details
    Field name Description
    vads_ship_to_status Status (PRIVATE: for private clients / COMPANY for companies).
    vads_ship_to_name Deprecated Buyer's last name. Use vads_ship_to_first_name and vads_ship_to_last_name.
    vads_ship_to_first_name First name.
    vads_ship_to_last_name Last name.
    vads_ship_to_legal_name Legal name
    vads_ship_to_phone_num Phone number.
    vads_ship_to_street_number Street number.
    vads_ship_to_street Postal address.
    vads_ship_to_street2 Second line of the address.
    vads_ship_to_district District.
    vads_ship_to_zip Zip code.
    vads_ship_to_city City.
    vads_ship_to_state State / Region.
    vads_ship_to_country Country code in compliance with the ISO 3166 standard
  3. Compute the value of the signature field using all the fields of your form starting with vads_ (see chapter Computing the signature).

Example of a payment form with shipping details
<form method="POST" action="https://secure.payzen.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="TEST" />
<input type="hidden" name="vads_currency" value="978" />
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_config" value="SINGLE" />
<input type="hidden" name="vads_ship_to_city" value="[...]"
<input type="hidden" name="vads_ship_to_country" value=FR />
<input type="hidden" name="vads_ship_to_name" value="[...]" />
<input type="hidden" name="vads_ship_to_street" value="[...]" />
<input type="hidden" name="vads_ship_to_street_number" value="10" />
<input type="hidden" name="vads_ship_to_zip" value="31670" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20140327143509" />
<input type="hidden" name="vads_trans_id" value="561095" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="52a8c87ec10b35e6fd1769e7189c26a6e279566e"/>
<input type="submit" name="pay" value="Pay"/>
</form>