Skip to main content

Recurring Processing Model

info

This field allows merchants to specify the type of recurring transaction being processed. We support different recurring payment scenarios and provide flexibility for various payment use cases.

Some things to keep in mind:

  • If recurringProcessingModel is included, the amount field can be set to 0 for card tokenization. (In this case you don't have to follow the minimum amount guidelines)

Accepted Values

ValueDescription
CardOnFileUsed when customers initiate payments with their stored payment details for a faster checkout experience.
SubscriptionUsed when merchants initiate recurring payments to charge customers at regular, fixed intervals.
UnscheduledCardOnFileUsed when merchants initiate payments at irregular intervals, such as automatic account top-ups or usage-based billing.

Request Example - Card Tokenization for Future Use

{
"amount": 0,
"currency": "ISK",
"returnUrl": "https://your-ecommerce-website.com/straumur_redirect",
"reference": "9990QQAZ1221",
"recurringProcessingModel": "CardOnFile"
}

Request Example - Card Tokenization with Subscription

{
"amount": 10000,
"currency": "ISK",
"returnUrl": "https://your-ecommerce-website.com/straumur_redirect",
"reference": "9990QQAZ1221",
"recurringProcessingModel": "Subscription"
}

Request Field

FieldTypeRequiredDescriptionExampleMin LengthMax Length
recurringProcessingModelStringOptionalSpecifies the type of recurring transaction.CardOnFile--