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

The illustration of support agent wearing a headset.

Do you need additional help?

Contact our support team

Send us the details of your issue by adding images or screenshots.

Submit a request