Subscription orders

↩ How it works

A new object inside the order flow makes any order eligible for recurring billing.

// Create order
{
  "controlFunctions": {
    "online":{
       "subscription": true, 
       "recurring": {
            "subscriptionAmountType": "fixed", 
            "maxAmount": 1000, 
            "frequency": "monthly", 
            "numberOfPayments": 12, 
            "uniqueReference": "1234567890", 
            "validation": "validated" 
       }
     }
  }
}

Set subscription to true and the order is tagged for recurring processing. Carbon will automatically store the necessary identifiers for future charges — keeping tokenization, payment method, and merchant logic consistent across billing cycles.

"controlFunctions": {
    "online":{
        "subscription": true,
    }
}

Built for flexibility

Partners can use subscription orders for:

→ Recurring memberships or digital services

→ Monthly or weekly product deliveries

→ SaaS and license-based billing

→ Hybrid setups combining one-time and recurring purchases

This structure gives you complete control: trigger recurring transactions at any interval, in any amount, using the same customer and token data stored on the original order.

If a consumer’s card is reissued, updated, or replaced, the subscription keeps working.

Carbon automatically links the new card to the same stored token and customer record, preventing transaction failures.

Partners can now offer subscriptions, memberships, and recurring plans with the same reliability and speed as any standard payment.

Partners get unified flows and full flexibility. Consumers get reliability that just works.