Eventos de transferência

​

Exemplo de payload entregue

{
  "id": "evt_payout_1001",
  "type": "payout.transferred",
  "api_version": "v2",
  "data": {
    "object": {
      "id": "018f1f2e-7b45-7c9a-8d3e-1a2b3c4d5e72",
      "status": "paid",
      "type": "pix",
      "amount": 1200,
      "fee": 50,
      "net_amount": 1150,
      "transferred_at": "2026-03-16T14:05:00.000Z"
    }
  }
}

​

Resposta de ACK

{
  "received": true
}

​

Eventos emitidos hoje

• payout.created
• payout.in_analysis
• payout.processing
• payout.transferred
• payout.failed
• payout.rejected — cancelado pelo parceiro bancário após o envio
• payout.canceled — interrompido antes da execução ou revertido depois

​

Erro comum de ingestão

{
  "error": "missing_event_id"
}

​

Guia de mapeamento

• payout.transferred significa que o recurso foi liquidado com status paid.
• payout.failed geralmente mapeia para status do recurso error.
• payout.rejected mapeia para status do recurso rejected: o parceiro bancário cancelou o payout após o envio. O valor não volta automaticamente para o seu saldo, então confira seu saldo e fale com o suporte antes de reenviar.
• payout.canceled mapeia para status do recurso cancelled: o payout foi interrompido antes da execução ou revertido depois. Um payout interrompido devolve o valor para o seu saldo; após uma reversão, confira seu saldo antes de encerrar a solicitação.
• Reconcilie quando o estado operacional e o estado do webhook divergirem.