Split Engine
Split Engine Presets
The Orchestrator provides five split engine presets. Each defines how incoming funds are distributed to recipients.
Percentage Split
Distributes funds by ratio. For example, a 50/30/20 split on GHS 100.00 sends GHS 50.00, GHS 30.00, and GHS 20.00 to three recipients. Rounding remainders are collected to a designated remainder recipient to ensure zero loss.
Fixed Flat Fee
Sends fixed GHS amounts to each recipient regardless of the total transaction value. Any remaining balance after all flat fees are deducted is routed to a designated remainder recipient.
Milestone Waterfall
Pools funds across multiple transactions. Disbursement only fires once the accumulated pool reaches a configured threshold (e.g. GHS 10,000). Ideal for batch payouts and reducing per-transaction fees.
Tiered Split
Volume-based commission that automatically shifts split percentages as 30-day revenue grows. Define tiers with thresholds (e.g. 0–GHS 50K at 10%, GHS 50K–200K at 8%, GHS 200K+ at 5%). The highest tier whose threshold is met is applied.
Recurring Collections
Scheduled payment requests on a recurring basis. Configure a customer ID, amount, and cron expression (e.g. every Monday at 9 AM). Each pull triggers a STK Push to the customer's phone for approval. Up to 3 retry attempts per cycle; auto-pauses after 6 consecutive failures.
Note: Moolre does not have native pull-based debit or mandate APIs. Each collection is a payment request that requires customer approval on their phone.
Comparison
| Preset | Split Logic | Remainder |
|---|---|---|
| Percentage | Ratio-based | Collected to remainder recipient |
| Fixed Flat | Fixed GHS amounts | Collected to remainder recipient |
| Milestone | Pool until threshold | Distributed after threshold met |
| Tiered | Volume-based tiers | Per-tier remainder collection |
| Recurring | Scheduled STK Push + split | Per-pull remainder collection |
Pre-Flight Name Validation
Before sending a disbursement, the Orchestrator can validate the recipient's name against the MoMo account's registered name using Moolre's identity validation API. This prevents accidental transfers to wrong accounts and provides an audit trail of identity checks.
Hard-Fail Mode (Default)
The payout is rejected if the recipient name does not match the registered MoMo account name. The full name is sent back in the error response for troubleshooting.
Soft-Fail Mode
The payout proceeds even on mismatch, but the discrepancy is flagged in the transaction detail panel with both the expected and registered names for manual review.
Set an optional recipientName on each recipient in your routing rule to enable validation. The validation mode is configured in merchant settings.

