Skip to main content
When subscriptions are enabled for a product, customers are able to set up a recurring automatic purchase during checkout such as a shipment of body wash every month. This allows customers more flexibility with setting up future “continuity” orders in advance, drives more regular sales, and allows product inventory to be replenished at a cadence. This feature also lets them test out the product for a trial period in advance of their full subscription. Subscriptions are offered as part of a eCommerce+OMS implementation, as well as a standalone product that does not include Kibo’s eCommerce storefront or Order Management. The standalone Subscriptions implementation still requires customer and catalog data such as discounts and products to be configured. For schemas of API calls associated with Subscriptions, see the API documentation. For information about the reporting that is available for subscription data, see the Reporting documentation.
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:
  1. 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.
  2. 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.
  3. 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.
Scope Statement: This guide covers subscription business value, core concepts, comprehensive business configuration strategies, lifecycle management, advanced operations, pricing capabilities, discount capabilities, payment handling, system-wide configuration strategy. It focuses on functional understanding and business applications without covering specific technical implementations, detailed configuration procedures, or API specifications.

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 requirements

Product 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 models

Subscription 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
Diagram of the subscriptions workflow: Pending, Active, Paused, Cancelled, and Errored These status definitions are fundamental for CSR teams managing customer relationships and for reporting systems tracking subscription performance and lifecycle analytics.

Subscription Pricing System

Functionality: Manages subscription-specific pricing, price locking mechanisms, promotional pricing structures, and installment payment options Business Purpose: Enables competitive subscription value propositions while protecting customer trust through price consistency and payment flexibility

Trial and Conversion System

Functionality: Handles trial product substitution, duration management, automated conversion to full subscriptions, and conversion optimization tracking Business Purpose: Reduces customer acquisition barriers and enables product demonstration before commitment while optimizing conversion rates

Communication and Notification System

Functionality: Manages proactive customer communications for status changes, upcoming orders, and required actions. Business Purpose: Reduces support burden while improving customer satisfaction through transparent communication and automated workflow integration

3.2 Business Configuration Deep Dive

This consolidated table highlights the most important, high-level settings that determine what subscription is offered and how the system operationally manages the recurring revenue stream.
Configuration NameBusiness PurposeImpact and Trade-offsConcrete Example
Subscription ModeDefines the fundamental purchasing commitment (one-time, mixed, or subscription-only).Directly impacts customer acquisition strategy; balances maximum recurring revenue potential against offering customer flexibility.A premium roaster sets artisanal blends to Subscription-Only to secure consistent monthly revenue.
Subscription FrequencyAligns automated delivery schedules with customer consumption patterns by offering pre-configured and custom frequencies.Balances customer satisfaction (offering variety) against operational complexity (inventory and fulfillment planning).A pet company offers Monthly and Bi-Monthly frequencies to match consumption rates for different dog sizes.
Trial DaysReduces commitment barriers by enabling a limited-time product experience before full commitment.Longer trials may delay revenue but increase acquisition potential; requires clear communication on the transition date.A meal kit service offers a 7-day trial to demonstrate quality before transitioning to the full subscription.
Trial Product Code / Variation CodeEffective trial products must demonstrate value while remaining cost-effective for customer acquisition and competitive with market alternatives.Enables a precise, cost-effective trial experience optimized for value demonstration and high conversion potential.A skincare brand uses sample-sized starter kits to control fulfillment costs.
Order Scheduling ControlsGoverns the timing of order creation (Create Continuity Order X Days Before Next Order Date), order date reset rules (Order Now Resets Next Order Date), and the limit for manually delaying the next order (Update Next Order Date Up to X Days)Important for controlling fulfillment lead times, improving inventory allocation, and governing customer/admin control over the delivery schedule.The system creates the order 7 days early for fulfillment planning. Ordering early via the Order Now action automatically resets the subsequent delivery schedule.
Skip / Pause ControlsLimits the number of consecutive orders a customer can skip and the total duration a subscription can remain paused before auto-reactivation. These are controlled by settings like Skip Subscription X Times and Pause Subscription Duration Limits.Balances providing customer flexibility during temporary needs changes against the strategic goal of long-term revenue retention.A customer can skip 2 orders. A paused subscription will auto-reactivate after three missed orders.
On-Demand Ordering ControlsSets a restriction period (Allow Order All or Partial Items Now Once Every X Days) after an on-demand “Order All/Partial Items Now” action is performed.Ensures appropriate timing between urgent fulfillment requests, maintaining overall subscription schedule integrity.On-demand ordering is restricted for 30 days after a partial order is placed early.
Communication & Notification StrategyManages timing, frequency, and triggers for all automated customer emails (reminders, status, modifications, reactivations).Enables proactive customer relationship management by providing important advance notice before the recurring order is created, setting expectations during lifecycle changes, and informing customers of account status and modificationsAn email is sent 3 days before an order processes, and a separate notification confirms the Subscription Status Change.
Subscription Attribute Scope SettingsDefines if custom data fields apply only to the subscription relationship, or to both the subscription and individual recurring orders.Enables the capture of unique data (e.g., compliance or project codes) that supports operational reporting, downstream fulfillment requirements, and financial reconciliation across the subscription lifecycle.A B2B client captures the “Department Budget Code” attribute, scoped to persist across all recurring orders

4. Key Capabilities and Business Applications

Capability: Automated Recurring Customer Relationships

Functional Explanation: Recurring orders serve as the foundation for transforming one-time transactions into ongoing customer relationships through automated order generation. The system automatically creates recurring orders based on customer-selected frequencies and configured business rules, handling payment processing, inventory allocation, and fulfillment coordination without manual intervention. This capability enables businesses to build predictable revenue streams while providing customers with seamless automated convenience for regularly consumed products and services. Business Application Example: Industry: B2B Industrial Distributor Scenario: A large manufacturing facility requires monthly shipments of industrial cleaning supplies for their production floors. The facility manager sets up a subscription for essential cleaning chemicals, safety equipment, and maintenance supplies with automated monthly delivery. When the subscription is active, the system automatically generates orders on the predetermined schedule, processes payments against the company’s stored payment method, and coordinates fulfillment with the distributor’s warehouse. This automation ensures the facility never runs out of essential supplies while eliminating manual reordering overhead for both the buyer and supplier, resulting in improved operational efficiency, reduced procurement costs, and stronger business relationships through reliable service delivery.

Capability: Strategic Subscription Offerings

Functional Explanation: The platform enables businesses to configure products with different subscription approaches based on strategic objectives and market positioning. Products can be offered exclusively through subscriptions to maximize recurring revenue, or businesses can provide customer choice between one-time purchases and subscription commitments. This flexibility allows companies to tailor their subscription strategy to different product categories, customer segments, and business goals while maintaining unified management across their subscription portfolio. Business Application Example: Industry: Fashion & Apparel Retailer Scenario: A premium athleisure brand wants to build recurring revenue while accommodating different customer preferences and market segments. They configure their core workout essentials like athletic tops and leggings as subscription-eligible with both one-time and subscription purchase options, offering a 15% discount for subscription commitments. However, their limited-edition seasonal collections are kept as one-time purchases only to maintain exclusivity and urgency. Meanwhile, their basic athletic socks and accessories are offered exclusively through subscription to ensure consistent replenishment revenue. This strategic model segmentation results in optimized revenue streams that balance customer acquisition flexibility with recurring revenue growth while maintaining product positioning integrity and brand differentiation.

Capability: Trial-to-Subscription Conversion Programs

Functional Explanation: Trial periods serve as powerful customer acquisition tools that reduce commitment barriers by allowing customers to experience products before committing to full subscriptions. The system automatically substitutes trial products during the evaluation period, then seamlessly transitions to full subscription fulfillment while maintaining all customer preferences including frequency, payment methods, and shipping information. This capability enables businesses to prove product value and optimize conversion rates through strategic trial design and targeted conversion communications. Business Application Example: Industry: Direct-to-Consumer Brand Scenario: A DTC beauty brand launching a monthly skincare subscription faces customer hesitation about committing to unknown products and recurring charges. They implement a 7-day trial program where new customers receive a sample-sized starter kit for the cost of shipping alone. During the trial period, customers experience the products while receiving personalized skincare tips and education emails designed to demonstrate value and build confidence. The system automatically transitions successful trials to full-sized monthly subscriptions at the standard pricing, while providing easy cancellation options for unsatisfied customers. This approach significantly increases customer acquisition by reducing perceived risk, resulting in higher conversion rates, more confident long-term subscribers who have already experienced product quality, and reduced customer service inquiries about product suitability.

Capability: Subscription-Specific Pricing Strategies

Functional Explanation: The platform provides sophisticated pricing mechanisms that enable businesses to offer different pricing for subscription versus one-time purchases, creating clear value propositions for recurring commitments. Price locking mechanisms protect subscribers from future increases while providing businesses with committed revenue at known margins. This capability allows companies to implement competitive “subscribe and save” programs while maintaining pricing integrity and customer trust through transparent pricing protection policies. Business Application Example: Industry: Enterprise Office Furniture Retailer Scenario: A large office furniture retailer offers enterprise office furniture solutions through both one-time purchases and annual subscriptions. For their executive office furniture suite, they price one-time purchases at $1,200 annually but offer subscription pricing at $95 per month with price protection guarantees for the subscription duration. Enterprise customers who choose subscriptions receive locked pricing for their subscription lifetime, protecting them from the typical annual price increases seen in office furniture markets. This pricing strategy attracts price-sensitive enterprise buyers while providing predictable revenue streams, improving customer retention through the value proposition of price protection against market increases, and enabling more accurate financial planning for both the retailer and their enterprise customers.

Capability: Strategic Discount and Promotional Management

Functional Explanation: The subscription platform supports sophisticated promotional strategies that can target different stages of the customer lifecycle and specific customer behaviors. Discounts can be applied exclusively to initial orders for customer acquisition, to all recurring orders for ongoing loyalty rewards, or to specific milestone orders for anniversary celebrations. Businesses can create frequency-based incentives to encourage longer commitments and implement complex promotional patterns that align with their customer retention and revenue optimization strategies. Business Application Example: Industry: DTC Specialty Coffee Brand Scenario: A specialty coffee roaster implements a multi-tiered promotional strategy to optimize customer acquisition and retention across different customer segments. New customers receive 20% off their first subscription order as an acquisition incentive to reduce barriers to entry. All active subscribers receive a 10% ongoing discount on recurring orders to reward loyalty and differentiate from one-time purchase pricing. Additionally, customers who choose monthly subscriptions instead of one-time purchases receive an extra 5% discount to encourage larger, recurring orders that improve operational efficiency and customer commitment. On the 12th recurring order, subscribers receive a special 25% “anniversary” discount along with a limited-edition coffee blend to celebrate loyalty milestones. This sophisticated promotional mechanism results in higher initial conversion rates, improved customer retention through ongoing value, increased average order values through frequency incentives, and stronger emotional connection through milestone recognition.

Capability: Payment Recycling

Functional Explanation: Payment recycling provides automated retry functionality for failed subscription payments through configurable rules that specify retry timing, intervals, payment types, and gateway response codes. When subscription payments fail due to issues like expired cards or insufficient funds, the system automatically attempts payment recovery based on configured schedules, specific payment gateway response codes, and payment method types. Recycling rules allow businesses to customize retry behavior including the number of retry days, intervals between attempts, specific authorization times, and payment type eligibility.This capability works independently or alongside installment plans and includes advanced features like automatic expiration year bumping during payment retry attempts. Business Application Example: Industry: B2B Office Supply Distributor Scenario: An office supply distributor serves hundreds of businesses with monthly supply subscriptions ranging from $500 to $5,000 per order. They configure payment recycling rules to automatically retry failed payments due to expired corporate credit cards, temporary credit limits, or processing errors. When a client’s monthly payment fails due to an expired card, the recycling system automatically retries the payment every 3 days for up to 15 days, with attempts scheduled during business hours to align with accounts payable processing times. The system can automatically bump expiration years for expired cards and targets specific payment gateway response codes that indicate recoverable failures.

Capability: Subscription Installments

Functional Explanation: Subscription installments enable businesses to offer payment flexibility by splitting subscription payments into multiple scheduled installments. When an order is placed with an installment plan, the system captures the first payment and schedules remaining payments according to configured frequencies and amounts. New subscription orders can be placed even when previous installments remain outstanding, with each order’s payments managed independently. Businesses can configure installment plans with specific numbers of payments, first payment amounts, payment frequencies, and shipping cost allocation, and can modify plans between orders or cancel individual payments as needed. Business Application Example: Industry: B2B Equipment Distributor Scenario: An industrial equipment distributor offers expensive machinery maintenance subscriptions for manufacturing facilities, with annual contracts ranging from $10,000 to $50,000. To make these subscriptions more accessible, they implement installment plans that allow customers to pay quarterly installments rather than large upfront annual payments. When a manufacturing facility subscribes to annual maintenance service worth $24,000, they can choose a 4-installment plan with quarterly payments of $6,000. The system automatically captures the first payment and schedules the remaining three payments every 90 days. This payment flexibility makes high-value subscriptions accessible to more customers while providing the distributor with committed annual contracts and predictable cash flow throughout the subscription period.

Capability: Subscription Attributes for Custom Data

Functional Explanation: Subscription attributes enable businesses to capture and store custom data fields specific to individual subscriptions beyond the standard subscription information. These custom order attributes can be configured as “Subscription Only” or “Order and Subscription” and appear in the subscription management interface for data collection and tracking. This capability allows businesses to gather subscription-specific information that supports personalization, operational requirements, regulatory compliance, or business intelligence needs while maintaining data integrity throughout the subscription lifecycle. Business Application Example: Industry: B2B Industrial Supply Distributor Scenario: An industrial supply company uses subscription attributes to capture operational data for B2B customers including “Department Budget Code,” “Project Reference Number,” and “Safety Compliance Level.” When a manufacturing facility subscribes to monthly safety equipment, these attributes ensure supplies are delivered to the correct department, charged to the appropriate budget, and meet required safety certifications. Customer service can quickly access this information when managing subscriptions, while sales teams use the data to identify expansion opportunities and optimize service offerings.

Capability: Historical Subscription Import

Functional Explanation: The platform supports comprehensive data migration capabilities that enable businesses to import existing subscriptions from legacy systems during platform transitions detailing the items in that subscription, payment and fulfillment information, and price list code. The import process ensures seamless business continuity while enabling businesses to leverage enhanced subscription capabilities without disrupting existing customer commitments. Business Application Example: Industry: Enterprise Office Furniture Retailer Scenario: A major office furniture retailer transitioning to Kibo Commerce has over 50,000 active office furniture lease subscriptions. Using the historical import capability, they migrate all active subscriptions detailing the items in that subscription, payment and fulfillment information, and price list code. The import process preserves existing customer relationships while enabling access to advanced subscription features. Customers experience no disruption in service or billing, while the retailer immediately benefits from improved subscription management tools and automation capabilities. This seamless migration prevents customer churn while enabling enhanced subscription functionality.

Capability: Localization Support

Functional Explanation: In order for subscriptions to work on international catalogs, you must set localized values for subscription attributes. This ensures subscription functionality operates correctly across different regional catalogs while maintaining appropriate regional customization for subscription data requirements.

5. Platform Integration Map

Upstream Dependencies

Product Catalog Management: Subscription capabilities require products to be configured with subscription eligibility settings. Product portfolios must be strategically organized to support subscription offerings while maintaining inventory and fulfillment compatibility across diverse subscription scenarios and business models. Pricing and Promotional Management: Subscription pricing leverages existing pricing structures while adding subscription-specific pricing rules and promotional capabilities. Price list configurations must support subscription pricing differentiation and discount linkage for effective promotional strategies, competitive positioning, and customer acquisition optimization. Customer Account Infrastructure: Subscriptions are fundamentally tied to customer accounts, requiring established customer profiles.

Downstream Impacts

Order Management System: Active subscriptions automatically generate recurring orders that flow through the standard order management system, requiring coordination with inventory management, fulfillment operations, and customer service processes for seamless subscription order processing, exception handling, and operational efficiency optimization. Customer Relationship Management: Subscription data provides rich customer insights that enhance CRM capabilities, enabling targeted marketing campaigns, customer lifecycle management, and retention strategies based on subscription behavior, preferences, lifecycle events, and predictive analytics for proactive customer engagement. Financial Management: Subscription revenue affects financial reporting, cash flow management, and revenue recognition processes, requiring integration with accounting systems and financial planning tools to accurately track and project subscription-based revenue streams, customer lifetime value, and financial performance optimization. Synergistic Features Loyalty and Rewards Programs: Subscriptions can be integrated with loyalty programs to provide enhanced rewards for subscription customers, exclusive access to special offers, and progression-based benefits that encourage long-term subscription commitments, higher customer engagement levels, and increased customer lifetime value through comprehensive value proposition enhancement. Personalization Engines: Subscription data enables sophisticated personalization strategies that can customize website experiences, product recommendations, and marketing communications based on subscription preferences, purchase history, behavioral patterns, and predictive analytics for enhanced customer experience and conversion optimization. Customer Segmentation: Subscription behavior provides powerful segmentation opportunities that enable targeted marketing campaigns, customized customer service approaches, and differentiated pricing strategies based on subscription value, loyalty, engagement levels, and lifecycle stage for optimized customer relationship management and revenue maximization. Marketing Automation: Subscription lifecycle events trigger automated marketing workflows that can include welcome sequences, retention campaigns, win-back programs, anniversary celebrations, and cross-selling initiatives that enhance customer engagement throughout the subscription journey and optimize customer lifetime value through strategic touchpoint management.

For foundational knowledge, refer to:

Catalog: Understanding how products are organized, categorized, and configured within the platform provides essential context for subscription product enablement strategies, portfolio development approaches, and inventory management considerations that underpin successful subscription operations and strategic business planning. Pricing: Subscription pricing strategies leverage the platform’s comprehensive pricing and promotional mechanism, requiring understanding of price list management, discount configuration, promotional targeting, and competitive positioning for effective subscription marketing, customer acquisition, and revenue optimization. Promotions: Understanding promotional targeting and campaign management enables sophisticated subscription discount strategies, milestone celebrations, and automated marketing workflows that enhance customer engagement throughout the subscription journey and optimize customer lifetime value.

To understand downstream impacts, refer to:

Order Routing: Recurring orders generated by subscriptions flow through the standard order management system, making understanding of order processing, fulfillment coordination, inventory management, and exception handling important for subscription operations optimization, customer experience enhancement, and operational efficiency improvement. Payments: Subscription transactions require sophisticated payment handling including recurring billing, payment failure recovery, financial reconciliation, and installment payment management, necessitating understanding of payment gateway operations and financial transaction management for subscription revenue optimization and customer retention. Fulfillment: Subscription operations require coordination with fulfillment processes to ensure seamless recurring order processing, inventory allocation, and delivery scheduling that maintains subscription commitments and customer satisfaction.

For complementary strategies, refer to:

Inventory: Subscription predictability enables enhanced inventory planning and demand forecasting, requiring understanding of inventory management capabilities for optimized stock levels and automated replenishment strategies.