General information

With a Thank-you page you define the page to which the end user is redirected after signing (or trying to sign) your document or pay an invoice. This can be a thank you page, a page on your own website or any other page of your choice. Always use http(s):// or, for mobile applications, the mobile prefix.
It is also possible to configure a global thank-you page which is directly used for both types. This overrides however both the contract and invoice thank you page.

Adding variables

You can add variables to your Thank-you page to adapt its content to the outcome of the signing or payment process. This way the end user will see a different page when he signs the mandate or pay the invoice successfully to when he encounters a problem.

Contract variables

The variable can be added in nominal ({{mandateNumber}}) or positional format ({0}). Beware: you cannot mix both.

The following variables are available:

• {0} or {{mandateNumber}} : mandate number
• {1} or {{status}} : status (ok = returned without error)
• ok: document is signed
• cancel: cancel in the signing flow
• fail: signature / authentication failed
• pending: signature still pending validation by the bank (automatic validation or validation of a digital signature)
• print: the customer printed the mandate and should register this manually at their bank. After uploading your acceptance is still needed
• {2} or {{account}} : IBAN/BIC encrypted with key privateKey+contract.getMandateNumber()
• {3} or {{s}} : signature over mandate and status separated by a slash (hex encoded)
• {4} or {{token}} : token (optional: if passed on in the incoming url)

Invoice variables

The invoice Thank-you page allows you to define a page shown when the customer paid the invoice. The type determines whether the url will be shown inside the page, as a popup or as a new page. For Modal or Popup please contact support, as these only support relative links for security.

The following variables are available:

• {{id}} : uuid of the invoice
• {{number}} : Invoice number
• {{locale}} : Locale of the invoice (Eg. nl_BE, nl_NL, nl)
• {{state}} : State of the invoice (Eg. pending, paid, ..)

4.1 Payment Service Providers

When a (global) thank you page is configured, we send the url directly to the PSP when available.
This means that the final handling of the URL is done via the payment service provider.
Some providers enrich the url with their own data, so it is possible that the final URL contains additional parameters.

Alternative without the need for extra development

If you want to avoid extra development, there is an alternative option. Take the following steps:

• Create the following pages for your website, contact your IT or marketing department for this. Often, this is a hidden page behind an extra folder. The words have to be exactly these words:
  • ok
  • cancel
  • fail
  • pending
  • print

Your Exit-url should look similar to this:
{{example.link}}/ok or {{example.link}}/cancel

• Add the general URL website in your profile [Settings > Profile > Thank-you page & Invoice thank-you page] and add {{status}}, including the brackets {}, at the location of the status.

Example:
www.yourwebsite.com/{{status}}

• The same applies for the Invoice Thank-you page.