Subscribing to Edge Webhooks

Receive real-time notifications when billing events occur

Before You Begin

A Zyntro account with admin access
An HTTPS endpoint to receive webhooks

Edge fires webhook events when charges succeed, fail, enrollments pause, or customers are created/suspended. Subscribe to react in real time: credit wallets, notify your team, update project status.

Steps

Navigate to Webhooks

Go to Account > API & Webhooks.

Add a Webhook

Click Add Webhook.

Enter Endpoint URL

Enter the HTTPS URL where Edge sends event payloads. Must be publicly accessible and return HTTP 200.

Select Events

Choose events under Trigger Billing Events: `trigger.captured`, `trigger.failed`, `trigger.pending_client`, `trigger.client_paid`, `trigger.enrollment.paused`, `trigger.enrollment.cancelled`, `billing_customer.created`, `billing_customer.suspended`.

Configure Authentication

Choose auth type: None, Bearer Token, Basic Auth, API Key, or Custom Header. Edge sends this with every delivery.

Note the Secret Key

Edge generates a secret key for HMAC signing. Your endpoint should verify the signature to ensure payloads are authentic.

Set Timeout and Retries

Set how long Edge waits for a response and how many times it retries on failure.

Save

Click Save. The webhook is now active.

Test It

Fire a test trigger charge and check your endpoint for the incoming event.

Result

Your webhook subscription is active. Edge delivers events to your endpoint in real time.

Sample trigger.captured Payload

json

{
  "event_id": "evt_abc123",
  "event_type": "trigger.captured",
  "api_version": "2026-03-30",
  "created_at": "2026-03-30T10:22:00Z",
  "org_id": "org_xxx",
  "data": {
    "charge_id": "sc_xxx",
    "revenue_id": "rev_xxx",
    "invoice_id": "inv_xxx",
    "billing_customer_id": "bc_xxx",
    "billable_item_id": "bi_xxx",
    "trigger_subscription_id": "ts_xxx",
    "amount": 200.00,
    "currency": "USD",
    "gateway": "stripe",
    "gateway_ref": "pi_xxx",
    "capture_mode": "off_session",
    "captured_at": "2026-03-30T10:22:00Z"
  }
}

Important: Edge uses the existing Zyntro webhook infrastructure. All events use the same HMAC signing, logging, and retry system as other Zyntro webhooks.

Continue Reading

5 min read Updated Apr 3, 2026

Navigation