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

# Webhook de Transação

> O Pixzy avisa seu sistema por POST a cada mudança de status da transação.

Informe uma `webhook_url` ao [criar uma transação](/endpoints/criar-transacao) e o Pixzy envia um `POST` para essa URL a cada mudança de status. Seu sistema reage na hora, sem ficar consultando a API.

## Eventos

<CardGroup cols={3}>
  <Card title="paid" icon="circle-check">
    Pagamento confirmado.
  </Card>

  <Card title="expired" icon="clock">
    QR Code expirou sem pagamento.
  </Card>

  <Card title="failed" icon="circle-x">
    Pagamento não foi concluído.
  </Card>
</CardGroup>

## Payload

```json theme={null}
{
  "event": "paid",
  "transaction": {
    "id": 8492,
    "amount": 1000,
    "status": "paid",
    "client_name": "João Silva",
    "client_email": "joao@email.com",
    "metadata": {
      "pedido_id": "ABC-123"
    },
    "created_at": "2025-01-15T10:00:00+00:00",
    "updated_at": "2025-01-15T10:01:30+00:00"
  }
}
```

<ResponseField name="event" type="string">
  Tipo do evento: `paid`, `expired` ou `failed`.
</ResponseField>

<ResponseField name="transaction" type="object">
  Dados da transação notificada.
</ResponseField>

<Tip>
  Responda `2xx` para confirmar o recebimento. Confira `event` e `status` antes de liberar o produto — trate o webhook como a fonte da verdade.
</Tip>