How does the link between Twikey and Payt work?

An explanation about the link between Twikey and Payt, and can be used to collect e-Mandates and/or direct debit.

Last updated: November 5, 2024

Once an agreement with Twikey has been signed, a link between Twikey and Payt can be established. To create the link, we need the following data:

  • API Key (this can be found in Twikey under 'Settings' -> 'API')
  • The template ID (attribute of the Twikey template to be used)

administration_settings_modules_emandates_api_identifier_twikey

The above data will be provided by Twikey.

After filling out these details, the module can be enabled by turning on the 'Request customers for direct debit authorisaton' toggle. Payt is then able to add an option to issue a direct debit authorisation when sending invoices or reminders.

Feed reset

It may occur that the mandate information in Payt is no longer up to date and does not match the actual information in Twikey. In that case, a feed reset needs to be done in Twikey, which works as follows:

  1. Go to your Twikey environment
  2. Open the 'Settings' and select 'API'
  3. Click on 'Reset feed'.

See also: https://www.twikey.com/api/#reset-the-feed

Once that is done, we can synchronize with Twikey to retrieve the correct mandate data.

Direct debit

In addition to collecting e-Mandates, Payt can be configured to perform direct debit via Twikey. When direct debit is configured in the Payt administration, there are a number of relevant settings:

  • It can be set when the direct debit should take place, e.g. x days before the due date. At the scheduled time, Payt will signal Twikey to perform the direct debit.  
  • You can set a limit for invoice amounts to be direct debited. Invoice amounts outside this limit will not be debited. You must set this limit equal to the limit specified in Twikey.

Note: In Twikey, debtors can also specify their own limit. It can occur that the debtor's limit is lower than the limit you set. If that debtor's invoices fall outside this limit, they will not be debited. 


When direct debit is configured, the e-mandates module is no longer applicable. 

Don't see the direct debit option in the Payt administration? Then it may still need to be configured by us. In that case, please contact the service desk.