How Limio's Order Orchestration Framework work

Introduction

The Order Orchestration Framework in Limio is a system designed to manage the end-to-end processing of orders and subscription changes. 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:

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

2. 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.

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

4. Extensibility: Custom logic can be added using plugins.

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).

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

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

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.

   • Learn more at: How Limio Events updates Zuora for Commerce

2. Salesforce Integration: Updates Salesforce objects from Limio events.

   • Learn more at: How can Limio Commerce update my Salesforce data?

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

   • Learn more at: Callout Plugin

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 Subscription Check Plugin

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.

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 [e-mail] to request a plugin activation or customisation.