Novas razões de cancelamento de Split decorrentes da validação de liquidação
Novos motivos de cancelamento de Split serão disponibilizados na API do Asaas. As integrações que utilizam Split de pagamentos devem estar preparadas para receber esses valores até 25/11/2026.
Esses motivos detalham falhas identificadas nas validações realizadas durante a liquidação do Split e permitem identificar com maior precisão a causa do cancelamento.
Os novos valores serão retornados no campo cancellationReason do objeto Split, nos endpoints que o retornam, incluindo a consulta de splits pagos, e, quando aplicável, nos Webhooks do evento PAYMENT_SPLIT_CANCELLED:
BANK_ACCOUNT_AWAITING_AUTHORIZATIONBANK_ACCOUNT_PENDINGBANK_ACCOUNT_REJECTEDCUSTOMER_DOCUMENTS_PENDINGCUSTOMER_DOCUMENTS_REJECTEDCHECKOUT_VALIDATION_FAILED
O motivo CHECKOUT_VALIDATION_FAILED passará a ser retornado quando a validação de checkout na liquidação do Split for ativada. Mesmo assim, prepare sua integração desde já para recebê-lo.
Os novos valores são adicionais. Nenhum campo foi removido ou renomeado, e os motivos já existentes, como WALLET_UNABLE_TO_RECEIVE, continuam sendo retornados normalmente. Os splits de assinatura não são afetados por essa mudança.
Splits recebidos
Para preservar informações da conta de origem do Split, os endpoints de splits recebidos não exibem esses motivos específicos. Para a conta de destino, o cancelamento é retornado de forma genérica como PAYMENT_SPLIT_VALIDATION_FAILED.
O mesmo vale para os motivos CHECKOUT_VALIDATION_FAILED e EXTERNAL_AUTHORIZATION_REFUSED, este último retornado quando a liquidação é recusada pelo Mecanismo para validação de saque via webhooks.
O que você precisa fazer
- Certifique-se de que sua aplicação esteja preparada para receber os novos valores no campo
cancellationReason, tanto nas respostas da API quanto nos Webhooks, quando aplicável. - Se sua aplicação consulta splits recebidos, trate também o valor
PAYMENT_SPLIT_VALIDATION_FAILED.
Ajuste seu código até 25/11/2026 para evitar falhas no processamento dos novos valores.