Introdução

Webhooks

Configure uma URL de webhook ao registrar ou atualizar sua conta. A p1v enviará eventos em tempo real para sua URL quando pagamentos forem confirmados ou saques processados.

Eventos disponíveis

Evento	Gatilho
payment.completed	PIX recebido e creditado na conta
payment.refunded	Envio de PIX processado
withdraw.completed	Saque concluído com sucesso
withdraw.failed	Saque falhou

Payload do webhook

json

{
  "event": "payment.completed",
  "txid": "pix_abc123xyz",
  "amount": "100.00",
  "netAmount": "99.50",
  "status": "completed",
  "paidAt": 1716700000
}

Sua URL de webhook deve responder com HTTP 200 em até 5 segundos. Configure em PUT /user/update com o campo webhookUrl.