Developer Documentation

Integrate the Orchestrator

Everything you need to connect the Ocuula payment orchestrator to your application — authentication, split engine, provisioning API, webhook system, and transaction tracking.

Documentation

Getting Started

Understand the core concepts — split engine, routing rules, and provisioning models.

Authentication

Authenticate API requests using API keys. Authorization headers, sandbox vs live environments.

Split Engine Presets

Five presets for distributing funds — percentage, fixed, waterfall, tiered, and direct debit.

Splits API

Trigger split executions and batch operations via the Orchestrator API.

Transactions API

Query transaction details and track the status of split executions.

Provisioning API

Dynamically provision merchants under your platform using the Orchestrator provisioning endpoint.

Outbound Webhooks

Signed webhook events dispatched to your destination URL whenever a split is processed.

Provisioning Models

The Orchestrator supports two merchant provisioning models:

Model A — Sub-Account

The parent merchant provisions a sub-account under its own tenant and Moolre credentials. Ideal for platforms that manage payments on behalf of sub-merchants.

Shared CredentialsSame Tenant

Model B — Direct Keys

The parent creates a new tenant organization with its own Moolre credentials. Each merchant manages their own API keys and settlement wallets.

Isolated TenantOwn Credentials