Order Orchestration Framework

Introduction

The Order Orchestration Framework in Limio is a system designed to manage the end-to-end processing of orders and subscription changes. Orders are sent from various source, including Limio Shop, Limio Self-Service, Limio for Salesforce or . It operates as an orchestration mechanism, moving from one step to the next in a defined sequence.

While some customers might require a simple orchestration, for example updating Salesforce then Zuora, you might have need for more extensibility - for example to manage fulfilment or entitlements.

The Order Orchestration framework ensures that:

• Orchestration: Orders move sequentially through processing steps, with all critical steps needing to pass for the order to complete successfully.

• Fault Tolerance: If any critical step fails, the order terminates with a failure message. This ensures error messages can be surfaced to end-user, while providing visibility to Limio admin users on what step failed.

• Customisation: From release 107 onwards, the framework can also trigger webhooks and process their responses.

• Extensibility: Custom logic or new partners can be added using plugins.

• Decomposition: Limio can allow to send part of the order to a specific system.

Key Features of the Framework

Orchestration and Plugins

The framework processes orders through a sequence of modular plugins, each responsible for a specific task such as validating customer data, synchronizing billing systems, or triggering external events. Plugins are highly configurable to meet diverse business requirements:

• Critical vs. Non-Critical: Critical plugins must pass for the order to proceed, while non-critical plugins can fail without halting the process. If all critical plugins succeed, the order reaches a completion state (e.g., order complete or change complete).

  • Example: Process an order even if the entitlement callout fails.

• Custom Logic: Developers can extend functionality by creating custom plugins to implement unique workflows.

  • Example: Call a third-party fulfilment provider to check for deliverability.

• Process Overrides for specific setup: The framework allows configuring different sequences of plugins based on order type (e.g., new, cancel, renew, change payment, refund), processing type (e.g., Express Apple Pay), or offer type (e.g. trial) ensuring flexibility in order handling.

  • Example: Pass free trial order to Salesforce but not Zuora.

Failures

All plugin failures will be visible in the Limio Events, with full logs available to troubleshoot. This allows operational team to understand failure points and remedy them. Learn more at:

How to see order failures with Process Events

Common Plugins

1. Zuora Integration: Pushes orders and changes in Zuora from Limio events

   • Limio also has an optional 'Zuora Sync' plug-in which allows to sync during order processing an existing Zuora Account into Limio. This allows Limio to find existing Zuora Accounts and merge the new order on that account. It requires passing the Zuora Account to Limio ahead of the order, either via an API made by custom component or stored in the JWT token then stored into the Limio order object.

   • Learn more at:

2. Salesforce Integration: Updates Salesforce objects from Limio events

   • Learn more at:

3. Callout Plugin: Enables integration with external APIs by sending payloads and processing responses

   • Learn more at:

4. Duplicate Subscription Check Plugin: Prevents customers from purchasing a new subscription if they already have an active subscription with that same product.

   • Learn more at: Duplicate

How to Configure Plugins

See your order processing

1. Navigate to Settings > Order Processing Config in Limio Settings

2. You will be able to see the order processing configuration for your tenant.

Screenshot 2025-01-23 at 17.13.40.png

Configure your order processing

Currently, order processing configuration is managed by Limio as part of configuring specific integration such as Zuora and Salesforce. If you require a customisation, please contact to request a plugin activation or customisation.

Adding new plugins

Limio is constantly adding new plugin partners to support hybrid billing strategies, new fulfillment and entitlement partners, and different CRMs. If you'd like a new partner to be offered as a plug-in, please contact