Skip to main content
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

transaction_created

Transação criada.

transaction_paid

Transação paga.

transaction_cancelled

Transação cancelada.
Se a entrega falhar, o Pixzy reenvia o webhook até 3 vezes, a cada 60 segundos.

​
Payload completo

{
  "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

​
event
string
Tipo do evento: transaction_created, transaction_paid ou transaction_cancelled.
​
transaction
object
Dados da transação, incluindo tax, net_amount, sale_origin e ip_address.
​
client
object
Dados completos do cliente (nome, documento, endereço).
​
products
array
Produtos associados à transação.
​
utms
object
Parâmetros UTM da origem da venda.