Canopypay Io Webhooks

generated: '2026-10-30'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://www.canopypay.io/agents/webhooks/raw
sources:
- https://www.canopypay.io/agents/webhooks/raw
- https://www.canopypay.io/webhooks
- https://www.canopypay.io/sdk/events
description: Canopy provides settlement webhooks that notify about the final state of a payment intent.
events:
- event: payment.settled
  description: Emitted when a payment intent has settled successfully. The verified payload’s `state` field is "settled".
- event: payment.failed
  description: Defined in the contract for failed settlements but not yet sent. The payload’s `state` field would indicate a failure.
delivery:
  signature: Each delivery includes the `webhook-signature` header containing one or more space‑separated `v1,<base64>` entries. Verification
    is performed with the signing secret (`whsec_…`) using the `standardwebhooks` library.
  retries: Canopy retries a delivery up to seven times (approximately twelve hours) if the endpoint returns a non‑2xx status, does not respond,
    or is disabled.
note: No IP allowlist or mutual TLS is used; the signature is the sole security mechanism.
docs: https://www.canopypay.io/agents/webhooks/raw