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 Merchant 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.: abc@example.com
    vads_cust_id Buyer reference on the merchant website an..63 E.g.: C2383333540
    vads_cust_title Buyer's title an..63 E.g.: Herr
    vads_cust_status Status

    enum

    PRIVATE: for a private individual

    COMPANY: for a company

    vads_cust_first_name First name ans..63 E.g.: Hanz
    vads_cust_last_name Name ans..63 E.g.: Dorn
    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.:
    vads_cust_address_number Street number ans..64 E.g.: 12
    vads_cust_address Postal address ans..255 E.g.: Bundesallee

    vads_cust_address2 Second line of the address ans..255 E.g.:
    vads_cust_district District ans..127 E.g.:
    vads_cust_zip Zip code an..64 E.g.:
    vads_cust_city City an..128 E.g.:
    vads_cust_state State / Region ans..127 E.g.:
    vads_cust_country Country code in compliance with the ISO 3166 standard a2

    E.g.: "AT" for Austria, "CH" for Switzerland, "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).