background

How to define a global thank-you page

Tags:profilesprofielprofielenglobalexit urlredirectthank youthank-youbedanktinvoicepayment linkdocumentsigningvariables
Show me

The global thank-you page is a single URL used to redirect your customer after they sign a document, pay an invoice, or pay a payment link.

When a global Thank-you page is configured for a language, the individual thank-you pages (thank you and invoice) for that language are disabled. If no global URL is configured for the language of the action (document, invoice, or payment link), the customer is redirected to a default page.

Configure the global thank-you page

  1. Navigate to Settings in the left-hand navigation menu.
  2. Find the Global Thank-you page section.
  3. Enter the URL per language.
  4. Click Save.
Always use https:// for your URL. Custom profile attributes cannot be used as variables in the global Thank-you page URL.

Available variables

The following variables can be added to the URL:

VariableDescription
{{type}}The type of action: document, invoice, or link
{{id}}The identifier of the action (see below)
{{ref}}The reference of the action (see below)
{{state}}The outcome of the action (see below)

Values per variable and type

{{id}}

TypeValue
documentDocument reference (mandate number, contract number)
invoiceInvoice number
linkPayment link ID

{{ref}}

TypeValue
documentContract reference defined on the profile
invoiceInvoice reference (ref parameter when creating via API or CSV)
linkPayment link remittance

{{state}}

TypeValue
documentok (signed), fail (error), pending (printed), cancel (cancelled)
invoicepaid
linkpaid, declined (payment failed or cancelled)

Implementation examples

You can structure your URL in different ways depending on how much handling you want to do on your end:

  • Static page per type: https://mythankyoupage.com/{{type}}/index.html
  • File per type: https://mythankyoupage.com/{{type}}.html
  • Pass all variables as query parameters: https://mythankyoupage.com?type={{type}}&id={{id}}&ref={{ref}}

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 handled by the PSP, which may enrich the URL with its own parameters.

Last Update: 2026-03-09