To begin setting up recurring credit card agreements, you must first verify that your payment service provider is properly configured to allow the collection of credit card transactions. Depending on your payment service provider, we also support zero-amount payments. This allows for the initial agreement to be signed without immediately charging the customer.
Once created, the profile and the selected gateway are configured for both one-off and recurring payments.
The necessary attributes are automatically added to the profile. You can add new attributes, but do not remove any of the preset ones — some are essential for signing agreements, collecting payments, or sending card expiry notifications.
When inviting a customer to sign a credit card agreement, you have two options:
When a new credit card agreement is created, an associated payment link is also generated. Once the document is signed, we update the Attributes on the agreement based on the information received from your payment service provider. This information exchange is one-to-one between Twikey and your PSP.
Recurring credit card transactions are processed differently from Direct Debits. When a credit card transaction is created, it is directly placed into a transaction batch. Unlike traditional transactions, you do not need to send this batch to the bank, except when RCC transactions are reoffered. After a short period, the transaction(s) are sent to the payment provider, and you subsequently receive feedback.
A new batch for recurring credit card transactions is automatically generated each day upon the creation of the first RCC transaction of the day. This batch contains all that day's transactions. Feedback for these transactions is provided on an individual basis.
When a transaction failure is received from your provider, Twikey maps it as closely as possible to standard R-codes so the correct dunning steps are taken automatically. Because each paymentservice provider has its own feedback mechanism, mapping is not always possible. In those cases, Twikey uses the general error code PY01 (Technical failure).