Webhooks

PayZu's webhook system allows your application to receive real-time notifications about transaction status changes. When you create a transaction and provide a callbackUrl, our system will automatically send updates to that URL whenever there's a status change.

The URL must be accessible and open for processing requests with the following header:

Content-Type: application/json

PayZu webhooks feature a robust retry system that ensures notification delivery even in case of temporary failures. When a notification is triggered, the system makes up to 5 delivery attempts with progressively longer intervals between each attempt. This approach guarantees that temporary unavailabilities or network issues won't prevent your notifications from being delivered, providing a reliable integration experience with PayZu systems.

The intervals between attempts are randomly varied within the specified ranges, which allows for better load distribution across servers and helps avoid request peaks that could overload the system. This progressive retry strategy means you can trust that your notifications will be delivered even in case of temporary problems, without needing to implement your own retry logic.

⚠️

Response Time Requirements

Your webhook must respond with HTTP 200 OK within 10 seconds. If the response time exceeds this limit, the system considers it a timeout and initiates the retry process.

To guarantee the integrity and security of notifications, it is strongly recommended to restrict access to your webhook URL. Only official IP addresses from the PROCESSAMENTO should be allowed to communicate with your endpoint. This prevents unauthorized access and ensures that all incoming notifications are legitimate and originate from PayZu systems.

Payload Fields