> ## Documentation Index
> Fetch the complete documentation index at: https://cakto-dece4a15.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão Geral

> Receba notificações em tempo real sobre pedidos, assinaturas e eventos de checkout via requisições HTTP POST automáticas.

## O que são Webhooks?

Os webhooks da Cakto enviam uma requisição **POST** com informações sobre cada pedido assim que um evento ocorre na plataforma.

<Info>
  A Cakto interpreta qualquer resposta do seu sistema como entregue com sucesso. Não é necessário retornar um status específico.
</Info>

## Como funciona

Cada requisição de webhook contém três campos principais:

| Campo    | Descrição                                                                  |
| -------- | -------------------------------------------------------------------------- |
| `secret` | Chave secreta configurada por você para validar a autenticidade da chamada |
| `event`  | Identificador do tipo de evento ocorrido                                   |
| `data`   | Objeto com todos os detalhes da transação                                  |

## Identificando o evento

Use o campo `event` presente em todos os payloads para identificar o tipo de notificação e processar cada caso adequadamente.

```json theme={null}
{
  "secret": "sua-chave-secreta",
  "event": "purchase_approved",
  "data": { ... }
}
```

<Tip>
  Sempre valide o campo `secret` antes de processar qualquer evento para garantir que a requisição veio da Cakto.
</Tip>