The transaction settlement flow occurs asynchronously after the user makes the payment through Pix.
Once the payment is made using the QR Code, in seconds Beeteller is notified of the operation and settles the charge.
Through a POST call, a message is sent to the merchant's system informing about the change of status in the transaction. Upon notification, the merchant's system shall query the details of the notified transaction using the following endpoint to ensure data integrity.
Recomendations
- The notification/webhook should only be used as a trigger to identify transaction status changes. After receiving the notification, it is advisable to query the details using the query endpoint.
- Add periodic queries to your internal flow to also identify status changes, as a contingency for when there is a problem in receiving the notification/webhook. While the user is on the payment screen in your checkout, perform periodic queries every 2 seconds to improve the user experience.
The notification/webhook payload that will be sent is described in the Webhook section.
Below is the complete diagram of the notification/webhook flow.
