← All webhook events

Subscribe to payment_link.used

A donation is made via a shared payment link - embedded in WhatsApp, email, or a third-party website.

When does payment_link.used fire?

AFTER donation.paid for the same donation, additionally signals that the donation originated from a payment_link rather than a direct campaign visit.

What developers build with it

• → Per-link conversion attribution
• → Channel-level fundraising ROI (WhatsApp vs email vs embed)
• → Re-targeting / cohort analysis on link-source URL
• → Auto-disable / extend a payment link based on usage

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 payment_link.used:

{
    "payment_link_id": 88,
    "donation_id": 12345,
    "ngo_id": 7,
    "donor_id": 482,
    "amount": 5000,
    "currency": "INR",
    "campaign_id": 18,
    "source_url": "https://www.donateazy.in/p/monsoon-relief",
    "used_at": "2026-05-15T10:24:01+05:30"
}

Subscribe to this event

From your NGO dashboard, head to System · Webhooks · Add new. Paste your HTTPS endpoint, copy the signing secret, tick payment_link.used 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'] !== 'payment_link.used') {
    http_response_code(202); exit; // not for this handler
}

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

Often paired with

All 20 webhook events