background

How to define a thank-you page

Tags:profilesprofielprofielenthank youthank-youbedanktredirectexit urlsigninginvoicevariablesstatus
Show me

A Thank-you page is where your end-customer is redirected after signing (or attempting to sign) a document, or after paying an invoice. This can be a page on your own website or any URL of your choice.

You can configure separate Thank-you pages for document signing and invoice payments. A global Thank-you page can also be configured — when set, it applies to both signing and invoice payments and overrides any individually configured Thank-you pages.

Configure a thank-you page

  1. Navigate to Settings in the left-hand navigation menu.
  2. Click Profiles.
  3. Click the profile you want to configure.
  4. Find the Thank-you page section.
  5. Enter the URL for document signing and/or invoice payments.
  6. Click Save.
Always use https:// for your URL. For mobile applications, use your mobile app prefix instead.

Adding variables

You can add variables to your Thank-you page URL to adapt its content based on the outcome of the signing or payment process. This way, the end-customer sees a different page depending on whether they signed successfully or encountered an issue.

Variables can be used in nominal format ({{mandateNumber}}) or positional format ({0}).
You cannot mix both formats in the same URL.

Contract variables

VariableDescription
{0} or {{mandateNumber}}Mandate number
{1} or {{status}}Outcome of the signing: ok (signed), cancel (cancelled), fail (signature/authentication failed), pending (awaiting bank validation), print (customer printed the mandate — manual registration at bank required)
{2} or {{account}}IBAN/BIC encrypted with privateKey + mandate number
{3} or {{s}}Signature over mandate and status, separated by a slash (hex encoded)
{4} or {{token}}Token (optional — only present if passed in the incoming URL)

Invoice variables

VariableDescription
{{id}}UUID of the invoice
{{number}}Invoice number
{{locale}}Locale of the invoice (e.g. nl_BE, nl_NL, nl)
{{state}}State of the invoice (e.g. pending, paid)

PSP behaviour

When a (global) Thank-you page is configured, Twikey sends the URL directly to the payment service provider where applicable. The final redirect is then handled by the PSP, which may enrich the URL with its own parameters.

Alternative without custom development

If you want to avoid custom development, you can create simple status pages on your website and use the {{status}} variable in your URL.

  1. Create the following pages on your website (exact names required):
    • ok
    • cancel
    • fail
    • pending
    • print
  2. Navigate to Settings > Profiles > open the profile > Thank-you page.
  3. Enter your base URL followed by {{status}}: www.yourwebsite.com/{{status}}
  4. Apply the same pattern to the Invoice Thank-you page field.

Your customers will automatically be redirected to the correct page based on the outcome.

Last Update: 2026-03-09