Webhook Events

Event	Description
TRANSACTION_COMPLETED	Triggered when a payout transaction is successfully completed.
TRANSACTION_REJECTED	Triggered when a payout transaction is rejected.
DEPOSIT_COMPLETED	Triggered when a deposit is successfully completed.
DEPOSIT_REJECTED	Triggered when a deposit is rejected.
USER_UPDATED	Triggered whenever a user's onboarding or verification status changes.
REMITTER_UPDATED	Triggered when a remitter is approved or rejected

Transaction Completed

{
    "event": "TRANSACTION_COMPLETED",
    "data": {
        "unique_id": "8e12df27-5286-4b9e-bfc3-36334b9f2172",
        "txn_ref_no": "0420260130043504716",
        "client_reference_id":"34234234",
        "utr_number": "603010189413",
        "total_amount": "9.59",
        "status": "COMPLETED",
        "remarks": ""
    },
    "timestamp": "2026-01-30 10:13:57"
}

Transaction Rejected

{
    "event": "TRANSACTION_REJECTED",
    "data": {
        "unique_id": "8e12df27-5286-4b9e-bfc3-36334b9f2172",
        "txn_ref_no": "0420260130043504716",
        "client_reference_id":"34234234",
        "utr_number": "",
        "total_amount": "9.59",
        "status": "REJECTED",
        "remarks": "Invalid Account Number"
    },
    "timestamp": "2026-01-30 10:13:57"
}

Deposit Completed

{
    "event": "DEPOSIT_COMPLETED",
    "data": {
        "unique_id": "8e12df27-5286-4b9e-bfc3-36334b9f2172",
        "total_amount": "9.59",
        "status": "COMPLETED",
        "remarks": ""
    },
    "timestamp": "2026-01-30 10:13:57"
}

Deposit Rejected

{
    "event": "DEPOSIT_REJECTED",
    "data": {
        "unique_id": "8e12df27-5286-4b9e-bfc3-36334b9f2172",
        "total_amount": "9.59",
        "status": "REJECTED",
        "remarks": "Invalid Account Number"
    },
    "timestamp": "2026-01-30 10:13:57"
}

User Updated

{
    "event": "USER_UPDATED",
    "data": {
        "unique_id": "8e12df27-5286-4b9e-bfc3-36334b9f2172",
        "email_status": "VERIFIED",
        "id_verification": "COMPLETED",
        "onboarding_step": "ONBOARDING_COMPLETED",
        "user_type": "BUSINESS",
        "user_status":"ACTIVE"
    },
    "timestamp": "2026-01-30 10:13:57"
}

Remitter Updated

{
    "event": "REMITTER_UPDATED",
    "data": {
        "unique_id": "894da1c6-b61d-4b69-b1fa-451f07f54a4d",
        "status": "APPROVED"
    },
    "timestamp": "2026-03-30 11:24:45"
}