Webhooks

Webhooks

Quando o status de uma cobrança muda, enviamos um POST com o novo estado para as suas URLs.

Para onde enviamos

A callback_url informada ao criar o PIX.
A URL configurada nas configurações da conta (legado).
URLs configuradas em Dashboard → Integrações → Webhooks.

Eventos

deposit.createdCobrança criada (pending).

deposit.paidPagamento confirmado.

deposit.expiredCobrança expirou sem pagamento.

deposit.refundedEstorno realizado.

deposit.cancelledCobrança cancelada.

Outros status terminais chegam como deposit.<status>, ex: deposit.chargeback.

Payload

Headers enviados: Content-Type: application/json e User-Agent: VenoPayments/2.0.

POST · sua URL

{
  "event": "deposit.paid",
  "data": {
    "id": "uuid-do-deposito",
    "txid": "identificador-pix",
    "external_id": "order-123",
    "status": "paid",
    "amount": 1000,
    "paid_at": "2026-03-23T14:30:00Z",
    "end_to_end_id": "E12345678202603...",
    "payer": {
      "name": "João Silva",
      "document": "12345678900",
      "email": "joao@email.com",
      "phone": "11999999999",
      "city": "São Paulo",
      "state": "SP"
    }
  }
}

Retentativas

Fazemos até 3 tentativas de entrega em sequência, com um pequeno intervalo crescente entre elas. Qualquer resposta 2xx conta como entregue; após a terceira falha, o evento não é reenviado automaticamente.