Webhooks

Webhook event object

Mighty Atom delivers a signed JSON payload to your registered endpoint whenever a payout or wallet event occurs. Every event shares the same envelope; the data object varies by type.

Envelope

`event`	The event type, e.g. payout.completed.
`payout_id`	Present on payout.* events.
`batch_id`	Present on batch.completed events.
`status`	Terminal or interim payout status.
`timestamp`	ISO 8601 time the event was generated.
`data`	Event-specific detail (amounts, rail, balance).
`signature`	HMAC-SHA256 signature of the raw body.

Event types

`payout.pending`	Payout received and queued for processing.
`payout.processing`	Submitted to the local partner rail.
`payout.completed`	Funds confirmed delivered to the recipient.
`payout.failed`	Could not be completed after all retries.
`wallet.credited`	Wallet balance was topped up.
`batch.completed`	All payouts in a batch reached a terminal state.

EXAMPLE · payout.completed

{
  "event": "payout.completed",
  "payout_id": "po_3kZ9x2",
  "status": "completed",
  "timestamp": "2026-06-24T09:14:22Z",
  "data": {
    "ghs_amount": 15420,
    "rail": "mobile_money",
    "recipient": "Ama Mensah"
  },
  "signature": "t=1719..,v1=8f3c.."
}

Failed deliveries retry with exponential backoff — up to 5 attempts over 24 hours. Open the simulator →