Enabling automatic return to the merchant website

In the payment form, the merchant can indicate if he/she wishes to automatically redirect the buyer to the merchant website at the end of payment.

If you use a tracking code (e.g. Google AnalyticsTM) on your website, you must implement this function.

IMPORTANT
The automatic return does not allow to offer additional attempts in case of refused payment.

  1. Use optional fields according to your requirements.
    Field name Description
    vads_redirect_success_timeout

    Defines the delay before the redirection that follows an accepted payment.

    This delay is presented in seconds and must be between 0 and 300 sec.
    vads_redirect_success_message Defines the message that appears before the redirection that follows a successful payment.
    vads_redirect_error_timeout

    Defines the delay before the redirection that follows a declined payment.

    This delay is presented in seconds and must be between 0 and 300 sec.
    vads_redirect_error_message Defines the message that appears before the redirection that follows a declined payment.

    Note

    If you choose a timeout to zero (= 0 delay) your redirection will be done as follows:
    • For an accepted payment, the buyer will be redirected to vads_url_success.
    • For a canceled payment, the buyer will be redirected to vads_url_cancel if this parameter is defined,
      • If the parameter is not filled in, the buyer will be redirected to the return URL entered in the vads_url_return field or to the return URL entered in the Expert Back Office.
      • If the return URL is not set, the buyer will be redirected to the merchant website.
    • For a declined payment, the buyer will be redirected to vads_url_refused if the setting is defined.
      • If the parameter is not filled in, the buyer will be redirected to the return URL entered in the vads_url_return field or to the return URL entered in the Expert Back Office.
      • If the return URL is not set, the buyer will be redirected to the merchant website.

  2. Set the vads_return_mode field to GET.
Example of a payment form:
<form method="POST" action="https://secure.lyra.com/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_redirect_error_message" value="You will be redirected to your merchant website" />
<input type="hidden" name="vads_redirect_error_timeout" value="0" />
<input type="hidden" name="vads_redirect_success_message" value="You will be redirected to your merchant website" />
<input type="hidden" name="vads_redirect_success_timeout" value="0" />
<input type="hidden" name="vads_return_mode" value="GET" />
<input type="hidden" name="vads_site_id" value="AL3d8Q" />
<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="AzTJmizS5N0muYzu63nVvCUWo0ixnMJfpqQmuEa4CSY="/>
<input type="submit" name="pay" value="Pay"/>
</form>