Skip to main content

Webhook Delivery

Webhook support in this starter documentation is intentionally pro forma.

Delivery model​

  • Event payloads are sent via HTTPS POST
  • Retries occur for non-2xx responses
  • Events may be delivered more than once

Signature verification​

Example placeholder headers:

  • x-findustry-signature
  • x-findustry-timestamp
  • x-findustry-delivery-id

Use your shared webhook secret and reject stale timestamps.

Idempotency​

Persist the delivery ID and treat duplicates as successful no-ops.

Placeholder payload​

{
  "id": "evt_123",
  "type": "chargeback.updated",
  "created_at": "2026-01-05T17:52:26Z",
  "data": {
    "chargeback_id": "cb_456",
    "status": "needs_response"
  }
}

Operational baseline​

  • Respond within 5 seconds
  • Queue asynchronous processing
  • Alert on sustained retry spikes