Validação de saque via Webhook para liquidação de Splits de Pagamento

A partir de 28/09/2026, o Mecanismo para validação de saque via webhooks também pode ser aplicado à liquidação de Splits de Pagamento.

Com a nova opção habilitada, sua aplicação recebe um Webhook de validação aproximadamente cinco segundos após a liquidação de cada Split e pode aprovar (APPROVED) ou recusar (REFUSED) a operação.

Como ativar

Acesse Menu do usuário > Integrações > Mecanismos de segurança e marque a opção Ativar autorização de saque para Splits de Pagamento.

A configuração é opcional, independente da validação dos demais saques e aplicada automaticamente às subcontas.

O que muda na integração

O Webhook de validação é enviado com o campo type igual a PAYMENT_SPLIT e com os dados do Split no objeto paymentSplit.

Enquanto a opção estiver ativa, todas as liquidações de Splits passam pela validação.

Quando sua aplicação recusa a liquidação, não retorna um status válido ou o Webhook falha três vezes consecutivas, o Split é cancelado e o valor retorna para a conta de origem. O motivo do cancelamento pode ser consultado no campo cancellationReason, pelos endpoints de consulta de splits:

• EXTERNAL_AUTHORIZATION_REFUSED: exibido para a conta de origem do Split (quem criou o Split);
• PAYMENT_SPLIT_VALIDATION_FAILED: exibido para a conta de destino do Split (conta favorecida), de forma genérica, sem detalhar a causa. Esse motivo também pode ser retornado em outras validações realizadas na liquidação do Split.

Nesse caso, não é enviado Webhook informando o cancelamento, e o evento PAYMENT_SPLIT_CANCELLED não é disparado.

Saiba mais

Consulte o guia Mecanismo para validação de saque via webhooks para ver o exemplo de payload e as regras de resposta.