background

How to define a thank-you page

Tags:profilesprofielprofielenthank youthank-youbedanktredirectexit urlsigninginvoicevariablesstatuspendingopen banking checkaccount checkfraud
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 (signed, but held for validation — see below), 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)

When the status is pending

A pending status means the signature was completed but the mandate is not usable yet. There are two situations:

  • Awaiting bank validation — The mandate still needs to be validated at bank side, for example for a B2B mandate.
  • A fraud rule was triggered — For an Open Banking Check signature, the signature itself succeeded but one of your fraud rules was hit. The action you configured on that rule is applied to the agreement: cancelled, marked as awaiting approval, marked as fraud, or another configured action (see Fraud rules settings for the full list).
Twikey deliberately does not tell your customer that a fraud rule was triggered. If you want to show your own message, enable the webhook action on your fraud rule and handle the pending redirect on your own screens.

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 (booked/in progress/paid/expired/archived)

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-08-20