Skip to main content
Read data.invoice_id from the webhook envelope and retrieve the authoritative invoice. This is the recommended verification flow for both intermediate and final statuses. Webhook signature verification is optional defense in depth and does not replace the API lookup.
To authenticate the callback before this lookup, verify X-Billions-Signature as described in Callbacks and security. The official SDKs now provide verifyWebhookSignature() in TypeScript and PHP, and verify_webhook_signature() in Python.
Add callback schema validation, order matching, and transactional idempotency before using these illustrative handlers in production. A callback status is informational until confirmed by the authenticated API.