Griffnode Com Webhooks

generated: '2026-11-10'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.griffnode.com/webhooks-setup
sources:
- https://docs.griffnode.com/webhooks-setup
- https://docs.griffnode.com/webhooks-events
- https://docs.griffnode.com/webhooks-verify
description: GriffNode webhooks push payment event notifications via signed HTTP POST callbacks.
events:
- event: payment.created
  description: A transaction was just created and is awaiting payment.
- event: payment.pending
  description: A payment was detected on-chain and is awaiting the required confirmations.
- event: payment.completed
  description: Transaction reached the required number of confirmations and is fully paid.
- event: payment.overpaid
  description: Fully paid, but the amount received exceeded what was owed.
- event: payment.partial
  description: An amount less than required was detected on the deposit address, transaction enters indefinite hold.
- event: payment.expired
  description: The 60‑minute payment window elapsed with no payment detected.
- event: payment.failed
  description: A system‑level failure prevented the transaction from completing normally.
- event: payment.paid_late
  description: Coins arrived on the deposit address within 6 hours after the payment window closed; funds are in the wallet but the order is not
    completed automatically.
- event: payment.needs_review
  description: 'For ETH/ERC‑20 only: the deposit address balance dropped while the checkout was open, so whether the customer paid can''t be determined.'
- event: recurring.confirmed
  description: The customer confirmed they want the recurring payment requests.
- event: recurring.payment.completed
  description: The customer paid a period of a recurring schedule.
- event: recurring.payment.unpaid
  description: A period's link expired unpaid and the schedule is paused.
- event: recurring.stopped
  description: The recurring schedule ended without you, due to customer stop, bounced email, or no confirmation.
delivery:
  signature: HMAC‑SHA256 of the raw request body using the webhook secret, sent in header X‑GriffNode‑Signature formatted as sha256=<hex>
  retries: 'Automatic retries with increasing delays: ~10 s, 1 min, 5 min, 30 min, then 1 h, 2 h, 4 h, 8 h, for up to 24 h after the event; delivery
    is marked failed after that.'
note: Endpoint must return an HTTP 2xx status within 10 seconds (or 15 seconds per verification page) to avoid a retry.
docs: https://docs.griffnode.com/webhooks-setup