Skip to main content

Recurring Transaction Agreements

A Recurring Transaction Agreement (RTA) is used to request that the Gateway should perform repeat payments on your behalf, using pre-agreed amounts and schedules.

An RTA can be configured easily and quickly, using the Merchant Management System (MMS). An RTA can also be set up while performing the initial transaction request, by including the integration Request Fields. The RTA is only set up in the transaction results in a successful payment authorisation.

The initial transaction should be either SALE or VERIFY transaction and the rtAgreementType field should be provided to indicate whether the transactions are part of a recurring or instalment.

Merchants who use this system to implement billing or subscription type payments must use recurring or instalment type Continuous Authority (CA) transactions to comply with Card Payment Scheme practices. Your Acquirer may refuse to accept the recurring transactions if they are not subject to an agreement between yourself and your Customer.

Mastercard require you to indicate if recurring payments will be for fixed or variable amounts. This can be indicated using the rtAmountFixed field, which can have a value of Y if the payments will be the same in each subsequent transaction, or N if the payments will be variable. If not provided, then N will be assumed. We advise you send this field for all fixed payment sequences, regardless of the card scheme in use. The Gateway will not attempt to determine the value of this field by examining the recurring payment schedule amounts, nor will it restrict the schedule to fixed amounts if provided with a value of Y.

The maximum period between recurring transactions is 13 months, however individual Acquirers may impose a shorter period.

Refer to the Credentials on File section for more information on the different types of repeat or recurring transactions.