Gnosis Pay Webhooks

generated: '2026-10-27'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.gnosispay.com/guides/webhooks/webhook.md
sources:
- https://docs.gnosispay.com/guides/webhooks/webhook.md
- https://docs.gnosispay.com/guides/webhooks/webhook-events.md
description: Gnosis Pay webhooks deliver real‑time event notifications over HTTPS POST requests. Each request includes a cryptographic Ed25519
  signature in the `X-Webhook-Signature` header and a Unix timestamp in `X-Webhook‑Timestamp`. Delivery is retried up to 5 times with a 30‑second
  timeout per attempt; 4xx responses are treated as permanent failures, while 5xx or connection errors trigger retries.
events:
- event: account.balance.changed
  description: Triggered when the account balance changes.
- event: account.created
  description: Triggered when a new account is created and provisioning begins.
- event: account.activated
  description: Triggered when account provisioning is complete and account becomes active.
- event: account.blocked
  description: Triggered when an account is blocked due to security or compliance reasons.
- event: kyc.profile.approved
  description: Triggered when a KYC profile verification is approved.
- event: kyc.profile.rejected
  description: Triggered when a KYC profile verification is rejected.
- event: kyc.profile.requires_action
  description: Triggered when a KYC profile requires additional action from the user.
- event: kyc.profile.resubmission_requested
  description: Triggered when KYC profile requires document resubmission.
- event: kyc.terms.approved
  description: Triggered when all required terms are accepted.
- event: kyc.source_of_funds.approved
  description: Triggered when source of funds questionnaire is submitted and approved.
- event: deposit.pending
  description: Triggered when an on‑chain deposit is detected and awaiting KYT processing.
delivery:
  signature: Ed25519 asymmetric cryptography
  retries: 'Max attempts: 5 retries; Timeout: 30 seconds per request; 4xx responses: permanent failure; 5xx/connection errors: retried up to maximum
    attempts'
docs: https://docs.gnosispay.com/guides/webhooks/webhook.md