Defining the method for receiving data

For statistical purposes or to display customized pages, the merchant site must be able to analyze certain data transmitted to the buyer’s browser.

By default, the payment gateway does not transmit any data when redirecting to the return URL.

However, the merchant website may activate the transmission of data to the return URL via the payment form.

  1. Use the fields required for your use case (see chapter Generating a payment form) to create your payment form.
  2. Use the vads_return_mode optional field to specify the method for submitting data to the merchant website.
    Value Description
    Absent, empty or NONE No data is transmitted.
    GET The information are transmitted in the URL of the return page.
    POST The information is transmitted via an HTTP in POST.

    The GET method allows to keep a notification message from appearing when the return is done from an insecure environment (http).

  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 definition of the mode for data transmission:
<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="3000" />
<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_return_mode" value="GET" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20140526101407" />
<input type="hidden" name="vads_trans_id" value="239848" />
<input type="hidden" name="vads_url_return" value="http://demo.com/return.php" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="oTCT+7Oc+xttdGmcp9qa6/0pSSfNxoMtl8U1J1l+LtE="/>
<input type="submit" name="pay" value="Pay"/>
</form>