Transmitting shipping details

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

This information can be found in the transaction details in the Merchant Back Office (Shipping 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.
    Table 1. Field list - Shipping details
    Field name Description Format Value
    vads_ship_to_city City an..128 E.g.: Berlin
    vads_ship_to_country Country code in compliance with the ISO 3166 standard. a2 E.g.: DE
    vads_ship_to_district District ans..127 E.g.: Niederdorf
    vads_ship_to_first_name First name ans..63 E.g.: Alfred
    vads_ship_to_last_name Name ans..63 E.g.: Dorn
    vads_ship_to_legal_name Legal name an..100 E.g.: D. & Cie
    vads_ship_to_phone_num Phone number ans..32 E.g.:
    vads_ship_to_state State / Region ans..127 E.g.:
    vads_ship_to_status Allows to specify the type of the shipping address.

    enum

    PRIVATE: for shipping to a private individual

    COMPANY: for shipping to a company

    vads_ship_to_street_number Street number ans..64 E.g.: 2
    vads_ship_to_street Postal address ans..255 E.g.: Hauptstr
    vads_ship_to_street2 Second line of the address ans..255
    vads_ship_to_zip Zip code an..64 E.g.: 10117
  3. 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 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="PRODUCTION" />
<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="shipping city" />
<input type="hidden" name="vads_ship_to_country" value="DE" />
<input type="hidden" name="vads_ship_to_name" value="the name of the shipping location" />
<input type="hidden" name="vads_ship_to_street" value="shipping street" />
<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="bOIxHAgm4vYUq3oIDCdEPKOWgrB9bHzkfDBEAr1i10A="/>
<input type="submit" name="pay" value="Pay"/>
</form>