Event-Driven Payouts

​

How it works

1. You ingest events (e.g., ride_completed, sale_made)
2. Monigo applies your payout rules to calculate amounts owed
3. Payout slips are generated per recipient
4. You trigger a batch transfer (or configure automatic triggers)
5. Monigo submits the transfers via your payment provider

​

Configuring payout rules

{
  "payout_rules": [
    {
      "trigger_event": "ride_completed",
      "recipient_field": "driver_id",
      "amount_expression": "fare * 0.80",
      "currency": "NGN"
    }
  ]
}

​

Triggering payouts

curl -X POST https://api.monigo.co/v1/payouts/trigger \
  -H "Authorization: Bearer mk_live_..."

​

Recipient bank accounts

curl -X POST https://api.monigo.co/v1/customers/{id}/payout-accounts \
  -d '{
    "provider": "paystack",
    "account_number": "0123456789",
    "bank_code": "058"
  }'

​

Payout slip lifecycle

​

Webhooks

• payout.batch.submitted — batch sent to provider
• payout.slip.paid — individual transfer confirmed
• payout.slip.failed — individual transfer failed