Insurance

Sample payloads for insurance.pending, insurance.success and insurance.failed.

The insurance events carry the insurance object. status is what distinguishes them.

Event	status
insurance.pending	pending
insurance.success	confirmed
insurance.failed	failed

insurance.pending

{
    "event": "insurance.pending",
    "data": {
        "insurance_id": "IN-70732333028",
        "amount": 600,
        "currency": "NGN",
        "value": 100000,
        "partner_charge": 500,
        "claim": "",
        "parcel": "PC-09857312356",
        "shipment": "SH-02314736509",
        "status": "pending",
        "user": "USER-27450202164",
        "metadata": {
            "platform": "octamile",
            "reference": "ild52fsgkfs8uu3gr736ikl2fe9s93jn"
        },
        "created_at": "2026-09-14T02:16:01.859Z",
        "updated_at": "2026-09-14T02:16:01.859Z"
    }
}

insurance.success

{
    "event": "insurance.success",
    "data": {
        "insurance_id": "IN-70732333028",
        "amount": 600,
        "currency": "NGN",
        "value": 100000,
        "partner_charge": 500,
        "claim": "",
        "parcel": "PC-09857312356",
        "shipment": "SH-02314736509",
        "status": "confirmed",
        "user": "USER-27450202164",
        "metadata": {
            "platform": "octamile",
            "reference": "ild52fsgkfs8uu3gr736ikl2fe9s93jn"
        },
        "created_at": "2026-09-14T02:16:01.859Z",
        "updated_at": "2026-09-14T02:44:18.207Z"
    }
}

insurance.failed

{
    "event": "insurance.failed",
    "data": {
        "insurance_id": "IN-70732333028",
        "amount": 600,
        "currency": "NGN",
        "value": 100000,
        "partner_charge": 500,
        "claim": "",
        "parcel": "PC-09857312356",
        "shipment": "SH-02314736509",
        "status": "failed",
        "user": "USER-27450202164",
        "metadata": {
            "platform": "octamile",
            "reference": "ild52fsgkfs8uu3gr736ikl2fe9s93jn",
            "description": "Insufficient wallet balance"
        },
        "created_at": "2026-09-14T02:16:01.859Z",
        "updated_at": "2026-09-14T02:44:18.207Z"
    }
}

insurance.failed can also be raised by the background status poller, which currently dispatches the event without a data object. Handle a missing data by fetching the insurance record with Get Insurance.