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.Documentation Index
Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt
Use this file to discover all available pages before exploring further.
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 |
|---|---|
LEDGER_TRANSACTION | A monetary transaction was posted to the ledger |
LEDGER_POSTING_EXCEPTION | An exception occurred while posting a transaction |
LEDGER_ACCOUNT_EXCEPTION | An exception occurred on a ledger account |
ACCOUNT_STATUS_CHANGED | A ledger account’s status changed |
ACCOUNT_RESTRICTION_CHANGED | A ledger account’s restrictions changed |
Payload structure
Every webhook delivery shares the same envelope. Only theeventType value and the contents of attributes differ between events.
| Field | Type | Description |
|---|---|---|
version | string | Payload schema version. Currently "1". |
deliveryId | string (UUID) | Identifier for this delivery. Stable across retry attempts of the same event - use it to deduplicate on your end. |
webhookUrl | string | The endpoint URL Tesouro is delivering to. |
deliveryDateTimeUtc | string (ISO 8601, UTC) | Server timestamp of the delivery attempt. |
attemptCount | string | Delivery attempt number - "1" on first attempt, higher on retries. |
eventType | string | The event type. See Event types. |
attributes | object | Event-specific fields. See Event types for the shape of each event’s attributes. |
Next steps
- Managing subscriptions: create and manage your webhook subscriptions
- Event types: payload schemas for each event
- Delivery and retry behavior: how Tesouro delivers events and retries failures