Developer Reference
See the Subscription API documentation for programmatic access
Watch: Subscription Configuration
Learn how to configure subscription attributes and create offline subscription orders
Watch: Subscription Site Settings
See how to configure subscription settings at the site level
Looking for webhook configurations? See Event Subscription for information about subscribing applications to Kibo platform events.
1. Strategic Overview
Concept Definition: Subscriptions enable automated recurring purchases through recurring orders, transforming one-time transactions into predictable, long-term customer relationships. Business Context: Kibo Commerce subscriptions serve as a foundational revenue optimization capability within the unified commerce platform. It is designed to manage the complete subscription lifecycle, from initial creation through ongoing payment processing and customer communications, by providing a dual management approach. Firstly, it offers comprehensive automation for recurring orders, payments, and standard communications, driving predictable revenue and operational efficiency. Secondly, the platform provides flexible direct management capabilities that allow users to intervene, modify, and manage subscriptions for necessary operational adjustments, personalized service and resolution of complex customer scenarios. Value Drivers:- Predictable Revenue Streams: Automated recurring orders create consistent, forecastable income that supports strategic planning and improves financial stability through recurring customer commitments, enabling more confident business investments and enhanced cash flow predictability.
- Operational Automation Excellence: Comprehensive automation of order generation, payment processing, inventory allocation, and customer communications eliminates manual intervention while reducing operational costs and human error across the entire subscription lifecycle.
- Enhanced Customer Lifetime Value: Long-term recurring relationships foster deeper customer engagement, provide extensive behavioral data for personalization, and create multiple touchpoints for additional value delivery and strategic cross-selling opportunities.
2. Core Concepts Explained
What is Subscription?
Subscriptions in Kibo Commerce represent a comprehensive recurring commerce solution that automates repeat purchases—transactions generated at predefined intervals based on customer-selected frequencies and configured business rules.The system transforms traditional one-time purchases into ongoing customer relationships by handling the complete subscription lifecycle: from initial setup and trial periods through recurring order generation, payment processing, fulfillment coordination, and lifecycle management.Why does Subscriptions matter?
Subscriptions are the core functional mechanism through which Kibo Commerce enables predictable revenue streams and operational automation. The platform’s comprehensive capabilities automates the transition from single purchases to long-term customer relationships. Kibo Commerce enables this through unified capabilities, including sophisticated payment recycling and installment options, providing customers with flexibility to choose between one-time purchases and recurring commitments, and flexible management features, ensuring scalability and fine-grained operational control over every recurring revenue stream.When to deploy Subscriptions?
Business Triggers: Deploy subscriptions for products with regular consumption patterns, curated collections requiring periodic delivery, services with ongoing access requirements, or high-value items benefiting from installment payment options. The system supports both B2C consumable replenishment and B2B bulk ordering scenarios, enabling diverse business models under unified subscription management while accommodating international expansion and complex operational requirements. Maturity Requirements: Subscription deployment requires established product catalogs, configured payment gateways supporting recurring transactions, defined customer account structures. Timeline to Value: The strategic decision to deploy is justified by a dual-phased value realization. Immediate Value begins upon the first subscription creation, as automated recurring orders instantly generate forecastable recurring revenue from the first billing cycle. Long-Term Value is realized through the adoption and configuration of advanced platform features, such as payment recycling and installment plans, which systematically enhance customer retention, reduce involuntary churn, and improve operational efficiency over time. This phased value realization supports both quick ROI and sustained growth across the entire customer base.3. Functional Components & Configuration Deep Dive
3.1 Component Architecture
The subscription system operates through a structured hierarchy of interconnected business components:Subscription Component
Functionality: Handles recurring order creation based on customer-selected frequencies, business rules, and operational timing controls Business Purpose: Enables predictable revenue streams and reduces manual order processing overhead while supporting complex scheduling requirementsProduct Configuration Component
Functionality: Defines subscription eligibility, frequency options, trial capabilities, and bundle configurations at product portfolio levels Business Purpose: Enables scalable subscription rollouts and consistent customer experience across product lines while supporting diverse business modelsSubscription Lifecycle Management
Functionality: Provides pause, skip, modification, and cancellation capabilities for both customers and service representatives with configurable automation policies Business Purpose: Reduces churn through flexibility while maintaining customer relationships during changing needs and circumstances Subscription Status Definitions: The subscription lifecycle is managed through distinct status states that control system behavior and enable appropriate customer service and reporting capabilities:- Pending: Subscriptions that have been created but not yet activated
- Active: Subscriptions that are active and generating recurring orders according to their configured frequency and business rules
- Paused: Subscriptions temporarily suspended by customer or administrative action, with automatic or manual reactivation capabilities
- Errored: Subscriptions where a problem occurred during processing, typically related to payment issues preventing the subscription from functioning normally. Resolution requires addressing the underlying issue to restore subscription operation
- Failed: Subscriptions where the system attempted multiple times to generate recurring orders but was unsuccessful, causing automatic order creation to stop. Manual intervention or successful order placement can restore normal subscription functionality
- Cancelled: Subscriptions permanently terminated by customer or administrative action, with no further recurring orders generated


