Webhooks

TxNod delivers seven canonical webhook event types to the URL you configure on each project. Every payload is signed with HMAC-SHA256 over the body and a millisecond timestamp; verify with constant-time compare and a ±300s tolerance BEFORE parsing the body. Deliveries carry a stable event_id for idempotent crediting and a mode discriminator (production, testnet, or sandbox). On a chain reorg, a paid event is followed by exactly one invoice.reverted; re-confirmation is idempotent.

• Webhook Event Types — the seven canonical events, their payloads, and the reorg-safety contract.
• Configuring partner webhooks — URL requirements, signing protocol, and retry / backoff behaviour.
• verifyWebhookSignature — the typed SDK helper for TypeScript projects.
• Invoices guide — per-chain confirmation thresholds at a glance.