Transmitting shipping details

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

To benefit from the PayPal merchant protection, you must transmit this data via the payment form. The protection only concerns the orders that require shipping. The shipping address known by PayPal must be exactly the same as the one where the package is sent.

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 with 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.: Bordeaux
    vads_ship_to_country Country code in compliance with the ISO 3166 standard. a2 E.g.: FR
    vads_ship_to_district District ans..127 E.g.: La Bastide
    vads_ship_to_first_name First name ans..63 E.g.: Albert
    vads_ship_to_last_name Name ans..63 E.g.: Durant
    vads_ship_to_legal_name Legal name an..100 E.g.: D. & Cie
    vads_ship_to_phone_num Phone number ans..32 E.g.: 0460030288
    vads_ship_to_state State / Region ans..127 E.g.: Nouvelle aquitaine
    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.: Rue Sainte Catherine
    vads_ship_to_street2 Second line of the address ans..255
    vads_ship_to_zip Zip code an..64 E.g.: 33000

    Note:

    The fields below are required and must be correctly filled out to enable you to benefit from the PayPal merchant protection.

    vads_ship_to_city, vads_ship_to_country, vads_ship_to_first_name, vads_ship_to_last_name, vads_ship_to_legal_name, vads_ship_to_phone_num, vads_ship_to_state, vads_ship_to_street, vads_ship_to_street2, vads_ship_to_zip

    This list is provided for information purposes and may be subject to change by PayPal. Please read the PayPal Terms of Use in order to benefit from this merchant protection.

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