Defining the Return URLs depending on the payment result

  1. Use the fields required for your use case (see chapter Generating a payment form) to create your payment form.
  2. Use the optional fields presented in the table below to create a customized payment form.If no URL is specified in the form, the value populated in the Back Office will be used.
    Field name Description
    vads_url_success URL where the buyer will be redirected in case of an accepted payment after having clicked on "Return to shop".
    vads_url_refused URL where the buyer will be redirected in case of a declined payment after having clicked on "Return to shop".
    vads_url_cancel URL where the buyer will be redirected after having clicked on "Cancel and return to shop" before processing the payment
    vads_url_error URL where the buyer will be redirected in case of a processing error on the payment gateway.
  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 a definition of a Return URL depending on the payment result:
<form method="POST" action="">
<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="TEST" />
<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_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_cancel" value="" />
<input type="hidden" name="vads_url_error" value="" />
<input type="hidden" name="vads_url_refused" value="" />
<input type="hidden" name="vads_url_success" value="" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="86b2a17b9a5fcefb6c0120c57b25ec86ad1704ee"/>
<input type="submit" name="pay" value="Pay"/>