Referência de
Webhooks

1. Funcionamento e Retentativas (Retry Policy)

A PixSplit utiliza Webhooks para informar o seu sistema assim que um pagamento é liquidado ou uma disputa MED é aberta. Devido à natureza assíncrona da internet, o seu servidor pode estar momentaneamente indisponível.

Para garantir que o seu ERP nunca perde um evento, o nosso motor (Celery) utiliza Exponential Backoff. Se o seu servidor não responder com um status HTTP 200 OK, tentaremos enviar o payload novamente durante 3 dias, em intervalos crescentes.

2. Estrutura do Payload (Pix Recebido)

Quando um cliente final efetua o pagamento de um Pix Imediato, o seu servidor configurado no Dashboard receberá um POST com a seguinte estrutura JSON:

{
  "event": "pix.paid",
  "txid": "7978c0c97ea847e78e8849634473c1f1",
  "e2e_id": "E182361202605151500s0123456789a",
  "amount": 150.00,
  "timestamp": "2026-05-15T15:00:00Z",
  "split_applied": true
}

Note que o txid é a chave primária que deve utilizar para reconciliar a fatura no seu lado.

3. Eventos do Mecanismo Especial de Devolução (MED)

Sempre que o Banco Central acatar uma notificação de infração contra a sua conta, enviamos imediatamente o seguinte alerta:

{
  "event": "med.dispute.opened",
  "dispute_id": "dis_123456789",
  "txid": "7978c0c97ea847e78e8849634473c1f1",
  "amount_blocked": 150.00,
  "reason": "Fraude reportada pelo banco pagador",
  "deadline": "2026-05-22T15:00:00Z"
}

Deve utilizar o dispute_id para chamar a nossa API de Resolução de Disputas antes do prazo limite (deadline) para contestar o bloqueio.