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.
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 data is transmitted in the browser URL. |
POST | The date is transmitted via an HTTP in request POST. |
The method GET allows to keep a notification message from appearing when the return is done from an insecure environment (http).
Example of a payment form with definition of the mode for data transmission:
<form method="POST" action="https://paiement.systempay.fr/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="20190626101407" /> <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>