> ## Documentation Index
> Fetch the complete documentation index at: https://developer.pagou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks Examples

> Runnable webhook handlers per language for the transaction, subscription and transfer event families.

Working code for the Webhooks flow: real handlers for the three current envelope families. Every handler
responds `2xx` fast, dedupes by top-level event id, offloads slow reconciliation, ignores redelivery,
and changes business state only on confirmed events. The public contract exposes no signature;
authenticity is established by reconciling against the API.

**Guide:** [Webhooks Overview](/webhooks/overview) · [Payment events](/webhooks/payment-events) ·
[Subscription events](/subscriptions/webhooks) · [Transfer events](/webhooks/transfer-events) ·
[Retries & reconciliation](/webhooks/retries-and-reconciliation)

Webhook delivery is inbound, so there is no OpenAPI operation to reference.

## Envelope families

| Family        | Match                                    | Discriminator     |
| ------------- | ---------------------------------------- | ----------------- |
| transactions  | `event = "transaction"`                  | `data.event_type` |
| subscriptions | `event = "subscription"`                 | `data.event_type` |
| transfers     | top-level `type` present + `data.object` | `data.object`     |

## Example code by language

| Language          | Directory                                                                                   | README                                                                                |
| ----------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| TypeScript / Node | [`typescript/webhooks/`](https://github.com/PagouAi/examples/tree/main/typescript/webhooks) | [README](https://github.com/PagouAi/examples/blob/main/typescript/webhooks/README.md) |
| Python            | [`python/webhooks/`](https://github.com/PagouAi/examples/tree/main/python/webhooks)         | [README](https://github.com/PagouAi/examples/blob/main/python/webhooks/README.md)     |
| PHP               | [`php/webhooks/`](https://github.com/PagouAi/examples/tree/main/php/webhooks)               | [README](https://github.com/PagouAi/examples/blob/main/php/webhooks/README.md)        |
| Java              | [`java/webhooks/`](https://github.com/PagouAi/examples/tree/main/java/webhooks)             | [README](https://github.com/PagouAi/examples/blob/main/java/webhooks/README.md)       |
| C# / .NET         | [`dotnet/webhooks/`](https://github.com/PagouAi/examples/tree/main/dotnet/webhooks)         | [README](https://github.com/PagouAi/examples/blob/main/dotnet/webhooks/README.md)     |
| Go                | [`go/webhooks/`](https://github.com/PagouAi/examples/tree/main/go/webhooks)                 | [README](https://github.com/PagouAi/examples/blob/main/go/webhooks/README.md)         |
| Ruby              | [`ruby/webhooks/`](https://github.com/PagouAi/examples/tree/main/ruby/webhooks)             | [README](https://github.com/PagouAi/examples/blob/main/ruby/webhooks/README.md)       |