How can I choose the Recurring Processing Model?
The recurringProcessingModel defines a recurring payment type. By default the recurringProcessingModel is set to Subscription. You can change the recurringProcessingModel on merchant account level. This will apply to all (recurring) transactions from your account. If you want to set the Recurring Processing Model on a transaction level, you should submit the values on your API request. Possible values are:
- Subscription: Contracts for a series of transactions with fixed or variable amounts, following a fixed time interval. If not set in the payment request, this will be the default value for shopperInteraction ContAuth.
- CardOnFile: Models where a shopper stores card details and then purchases from the website or app at a later time using the stored card details.
- UnscheduledCardOnFile: Contracts that occur on a non-fixed schedule and/or have variable amounts using stored card details. For example, automatic top-ups when the cardholder's balance drops below a certain amount.
The following table shows common business models with the corresponding Payment request parameters (Shopper Interaction and Recurring Processing Model).
Business model
Transaction type
Payment request parameters
Shopper Interaction
Recurring Processing Model
Online purchase with shopper in-session
One-off online purchase where a shopper enters card payment details on the checkout page.
Ecommerce
Online purchase where the shopper agrees to store card details for future use on your website or app. This can be a zero-value transaction.
Ecommerce
CardOnFile
Online purchase where the shopper uses previously stored card payment details.
ContAuth
CardOnFile
Subscriptions
First transaction to sign up for a subscription. This can be a zero-value transaction. The terms and conditions should describe the policy for later subsequent charges, for example, fixed or variable amounts.
Ecommerce
Subscription
Subsequent subscription charges as described in the initial terms and conditions during the sign-up transaction, following equal time intervals.
ContAuth
Subscription
Contracts with non-fixed time interval, such as auto account top-ups
Initial transaction where the shopper agrees to the terms and conditions of later subsequent charges. This can be a zero-value transaction.
Ecommerce
UnscheduledCardOnFile
Subsequent charges as described in the initial terms and conditions during the sign-up transaction, following non-fixed time intervals.
ContAuth
UnscheduledCardOnFile
Was this article helpful?
Related content
