Send Money Events

Webhook send money events examples and definition

Send money event payload will be sent to you in real-time every time when the status field changes. Please ensure you have validated the challenge provided.

Payload example

{
  "file_id": "0VZ4MOK",
  "tracking_id": "f89r8b57-f647-4960-933a-63874746005f",
  "batch_reference": null,
  "status": "Completed",
  "status_code": "BC100",
  "transactions": [
    {
      "transaction_id": "YP3I6V4",
      "status": "Successful",
      "status_code": "TS100",
      "status_description": "The service request is processed successfully.",
      "request_reference_id": "cik94566-9c1c-4db0-94f7-a1b344d99fd4",
      "provider": "MPESA-B2C",
      "bank_code": null,
      "name": "Jane Doe",
      "account": "254712345678",
      "account_type": null,
      "account_reference": null,
      "provider_reference": "TJRHC8IET4",
      "provider_account_name": " Jane Doe",
      "amount": "38.00",
      "charge": "10.00",
      "narrative": "airtime needed",
      "file_id": "08Z4GOK",
      "idempotency_key": null,
      "currency": "KES",
      "created_at": "2025-10-27T10:44:23.852593+03:00",
      "updated_at": "2025-10-27T10:44:39.017422+03:00"
    }
  ],
  "actual_charges": "10.00",
  "paid_amount": "38.00",
  "failed_amount": 0.0,
  "wallet": {
    "wallet_id": "0XDLWNK",
    "label": "default",
    "can_disburse": false,
    "currency": "KES",
    "wallet_type": "SETTLEMENT",
    "current_balance": "0.50",
    "available_balance": "0.50",
    "updated_at": "2025-10-27T10:44:24.265189+03:00"
  },
  "charge_estimate": "10.00",
  "total_amount_estimate": "48.00",
  "total_amount": "38.00",
  "transactions_count": 1,
  "created_at": "2025-10-27T10:44:23.775560+03:00",
  "updated_at": "2025-10-27T10:44:39.042040+03:00"
}

Status field reference