Attributes on a credit card agreement
When creating a recurring credit card agreement, you will see different extra attributes on the document.
Some are mandatory, others can be added to display additional information from your payment provider or to pass a value.
Attributes
- amount: The amount of the first payment when signing the agreement (zero-amount is supported by some payment providers).
- _cust: The customer ID from your payment service provider. Required when using Mollie as a PSP.
- _psptoken: The reference token to the credit card agreement from your payment service provider.
- _cctype: The card type used to sign (e.g. visa, mastercard). Only returned by some payment providers (MultiSafePay, CCV).
- _last: The last 4 digits of the card used to sign.
- _expiry: The expiry date of the card (only returned by some payment providers). When present, a renewal task is created one month before expiry.
- pl_: The payment link ID used to sign the agreement (first payment).
- method: A specific signing method can be passed when creating the agreement (visa, mastercard).
Expiry of the credit card agreement
If we receive the expiry date from your payment service provider, a task is created on the agreement one month before the card expires. Twikey will attempt to renew the credit card automatically if the Automatic credit card renewal option is enabled on your credit card profile. If this option is disabled, the agreement is cancelled when the task executes.
If we did not receive the expiry date from your payment provider, it is logged in the events of the agreement.
Set a predefined signing method
When you want your customer to use a specific card type when signing, you can add the method attribute.
You can assign a default value or pass a value when creating a new agreement. Supported values are visa and mastercard.