Assets

Webhooks are a powerful tool for receiving real-time notifications about your payment updates from Zero Hash's systems. By configuring webhooks, you can streamline your workflow and stay informed about events related to your payments.

Configuring Webhooks

• Contact Zero Hash: Reach out to Zero Hash directly to initiate the webhook configuration process. You can do this via the platform Slack channel or by contacting your Zero Hash relationship manager.
• Provide URLs: Provide the URLs for your production (Prod) and certification (Cert) webhooks to Zero Hash. These URLs will be where Zero Hash sends the webhook payloads.
• Wait for Configuration: Zero Hash will configure the webhooks within 2 business days of receiving the URLs. Once configured, you will start receiving webhook notifications according to your participant events.

Webhook URLs

Ensure that you provide separate URLs for production and certification environments. This helps in distinguishing between live and test data, allowing you to safely test webhook integrations without affecting your production environment.

Handling Webhook Payloads

Upon receiving webhook payloads, your system should be capable of processing and interpreting the data. Parse the payload according to the provided documentation and handle events appropriately based on your application logic.

Retry Policy

• Upon failure to send a webhook notification, Zero Hash will make up to 4 additional fast retry attempts.
• Each fast retry is delayed by 250 milliseconds before contacting your webhook listener.
• If all fast retries are exhausted, the notification is enqueued and re-attempted 3 more times using an exponential backoff strategy.
• If all retries with exponential backoff are exhausted, the notification is dropped. The client must then perform a manual state recovery upon resuming operation.

Sequencing and order

The client should interpret event sequence not by the order of each webhook message, but instead by the timestamp field.

📘

Order of webhooks

When sorting webhooks to determine the sequence by which they happened, use the timestamp field. This field determines when the event associated with the webhook took place. Conversely, you should not rely on the order by which you receive the webhook to determine the sequence.