> ## 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 Integração

> Payload completo com transação, cliente, produtos e UTMs — filtrável por produto e evento.

O webhook de integração entrega o **payload completo** de cada venda: transação, cliente, produtos e UTMs. Você pode filtrar por **produto** e por **evento**.

## Eventos

<CardGroup cols={3}>
  <Card title="transaction_created" icon="plus">
    Transação criada.
  </Card>

  <Card title="transaction_paid" icon="circle-check">
    Transação paga.
  </Card>

  <Card title="transaction_cancelled" icon="ban">
    Transação cancelada.
  </Card>
</CardGroup>

<Note>
  Se a entrega falhar, o Pixzy reenvia o webhook até **3 vezes**, a cada **60 segundos**.
</Note>

## Payload completo

```json theme={null}
{
  "event": "transaction_paid",
  "transaction": {
    "id": 8492,
    "external_id": null,
    "amount": 1000,
    "amount_formatted": "R$ 10,00",
    "tax": 150,
    "net_amount": 850,
    "status": "paid",
    "sale_origin": "checkout",
    "ip_address": "187.45.123.89",
    "created_at": "2025-01-15T10:00:00+00:00",
    "updated_at": "2025-01-15T10:01:30+00:00"
  },
  "client": {
    "name": "João Silva",
    "email": "joao@email.com",
    "doc": "123.456.789-00",
    "phone": "11999999999",
    "zip": "01310-100",
    "address": "Av Paulista",
    "number": "1000",
    "complement": "Sala 12",
    "neighborhood": "Bela Vista",
    "city": "São Paulo",
    "state": "SP"
  },
  "products": [
    {
      "id": 1,
      "product_id": 42,
      "name": "Curso de Marketing",
      "price": 1000,
      "price_formatted": "R$ 10,00",
      "type": "main"
    }
  ],
  "utms": {
    "utm_source": "google",
    "utm_medium": "cpc",
    "utm_campaign": "black-friday"
  }
}
```

## Estrutura do payload

<ResponseField name="event" type="string">
  Tipo do evento: `transaction_created`, `transaction_paid` ou `transaction_cancelled`.
</ResponseField>

<ResponseField name="transaction" type="object">
  Dados da transação, incluindo `tax`, `net_amount`, `sale_origin` e `ip_address`.
</ResponseField>

<ResponseField name="client" type="object">
  Dados completos do cliente (nome, documento, endereço).
</ResponseField>

<ResponseField name="products" type="array">
  Produtos associados à transação.
</ResponseField>

<ResponseField name="utms" type="object">
  Parâmetros UTM da origem da venda.
</ResponseField>