Webhook de Transação

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"
    },
    "items": [
      { "name": "Curso de Marketing", "price": 700, "quantity": 1 }
    ],
    "created_at": "2025-01-15T10:00:00+00:00",
    "updated_at": "2025-01-15T10:01:30+00:00"
  }
}

string

Tipo do evento: paid, expired ou failed.

object

Dados da transação notificada.

array

Itens do pedido informados na criação da transação. Cada item traz name, price (em centavos) e quantity. Presente em todos os eventos — array vazio se a transação não tiver itens.

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

Começando

Webhooks

Extras

Webhook de Transação

Eventos

paid

expired

failed

Payload

​Eventos

paid

expired

failed

​Payload

Eventos

Payload