What is a Webhook?
An HTTP callback that notifies your server when a payment event occurs.
A webhook is an automated HTTP POST request sent from Zateway to your server when a payment event occurs (e.g., payment confirmed, payment expired, payment failed). Instead of polling the API for status updates, webhooks push real-time notifications to you.
How Webhooks Work
When you create a payment session, you provide a webhookUrl. When the payment status changes, Zateway sends a signed POST request to that URL with the full payment details. You verify the HMAC signature and update your system accordingly.
Webhook Security
All Zateway webhooks are signed with HMAC-SHA256 using your webhook secret. Always verify the signature before processing. The payload includes the session ID, amount, chain, token, txHash, and status.