← All webhook events

Subscribe to grant.disbursement

A grant tranche is disbursed to a beneficiary, programme or sub-grantee.

When does grant.disbursement fire?

A disbursement row lands with tranche_number, amount, disbursed_at, and (for PFMS-linked grants) the unique PFMS UID.

What developers build with it

• → Mirror to PFMS dashboard / GFR-12A report builder
• → Trigger beneficiary SMS / WhatsApp acknowledgement
• → Reconcile against bank statement automatically
• → Update grant burn-rate chart in your MIS

Sample payload

The full envelope (with HMAC-SHA256 signature, delivery UUID and headers) is documented on the webhooks hub page. Below is the per-event data block for grant.disbursement:

{
    "disbursement_id": 1142,
    "grant_id": 33,
    "ngo_id": 7,
    "tranche_number": 2,
    "amount": 625000,
    "currency": "INR",
    "disbursed_at": "2026-08-01T11:30:00+05:30",
    "beneficiary_id": null,
    "pfms_uid": "PFMS/2026/3812",
    "utilisation_certificate_url": "https://www.donateazy.in/grants/33/uc-2"
}

Subscribe to this event

From your NGO dashboard, head to System · Webhooks · Add new. Paste your HTTPS endpoint, copy the signing secret, tick grant.disbursement in the events list, save. The first matching event fires within seconds. Verify the X-Donateazy-Signature header on every request.

// PHP example - drop into your webhook receiver
$raw = file_get_contents('php://input');
$expected = hash_hmac('sha256', $raw, $WEBHOOK_SECRET);
if (! hash_equals($expected, $_SERVER['HTTP_X_DONATEAZY_SIGNATURE'] ?? '')) {
    http_response_code(401); exit;
}

$payload = json_decode($raw, true);
if ($payload['event'] !== 'grant.disbursement') {
    http_response_code(202); exit; // not for this handler
}

// $payload['data'] is the block documented above.
handleGrantDisbursement($payload['data'], $payload['id']);
http_response_code(200);

Often paired with

All 20 webhook events