Skip to main content
Webhooks let your system receive real-time notifications when events occur on the Tesouro platform. Tesouro delivers these as HTTP POST requests to an endpoint you register. Unlike polling the API, webhooks push data to you when an event occurs reducing latency and API load.
Your endpoint must return a 2xx status code to acknowledge receipt. Process payloads asynchronously. Heavy processing in the request handler risks timeouts and failed deliveries.

How it works

Embedded banking webhooks use a subscription model. You explicitly subscribe to the event types you want to receive, and Tesouro delivers matching events to your registered endpoint. Each subscription is created and managed through the managing subscriptions guide.

Supported events

Event typeDescription
MBP_MONETARY_TRANSACTIONA monetary transaction occurred on the Modern Banking Platform
MBP_PUBAR_EXCEPTIONA PUBAR exception occurred on the Modern Banking Platform
See Event types for payload details.

Next steps