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 type | Description |
|---|
MBP_MONETARY_TRANSACTION | A monetary transaction occurred on the Modern Banking Platform |
MBP_PUBAR_EXCEPTION | A PUBAR exception occurred on the Modern Banking Platform |
See Event types for payload details.
Next steps