General information

A Thank-you page defines where an end-user is redirected after signing (or trying to sign) your document or paying an invoice. This can be a thank you page or a page on your own website or any other page of your choice.

The URL must always start with http(s):// or, for mobile applications, the mobile prefix.

You can configure separate thank-you pages for document signing and invoice payments.
Additionally, it is possible to configure a global thank-you page.

When set, the global thank-you page is used for both document signing and invoice payments and overrides any individually configured thank-you pages.

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 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, ..)

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 follow this structure:
{{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.