Skip to main content
Informe uma webhook_url ao criar uma transação 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

paid

Pagamento confirmado.

expired

QR Code expirou sem pagamento.

failed

Pagamento não foi concluído.

​
Payload

{
  "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"
  }
}
​
event
string
Tipo do evento: paid, expired ou failed.
​
transaction
object
Dados da transação notificada.
Responda 2xx para confirmar o recebimento. Confira event e status antes de liberar o produto — trate o webhook como a fonte da verdade.