Motivos de Recusa

Durante o processamento das instruções de pagamento do Pix Automático, a cobrança pode ser recusada pelo Asaas ou pela instituição financeira do pagador.

As recusas representam situações que impedem o agendamento ou a liquidação da cobrança recorrente e devem ser tratadas pela integração para garantir uma experiência adequada ao usuário.

Esta página apresenta os principais motivos de recusa e os comportamentos esperados em cada cenário.

Quando utilizar

Consulte esta página quando:

Uma instrução de pagamento retornar status de recusa.
Eventos de webhook indicarem falha no processamento da cobrança.
For necessário apresentar mensagens mais claras ao usuário.
A aplicação precisar decidir entre realizar uma nova tentativa ou interromper a recorrência.
For necessário diagnosticar falhas retornadas pelo Asaas ou pela instituição do pagador.

Como funcionam as recusas

Ao tentar efetivar uma cobrança do Pix Automático, o Asaas envia uma instrução de pagamento para a instituição do pagador.

Dependendo das validações realizadas pelo banco ou pelo próprio Asaas, a instrução poderá ser recusada.

As recusas podem ocorrer por motivos como:

falta de saldo ou limite;
divergências cadastrais;
restrições da autorização;
erros operacionais da instituição financeira;
tentativa de cobrança fora da janela permitida;
quantidade máxima de tentativas excedida.

📘
Importante
Uma recusa não significa necessariamente falha da integração.
Em muitos casos, a recusa é resultado de regras operacionais do banco pagador ou das restrições da própria autorização do Pix Automático.

Recusas retornadas pelo Asaas

Alguns cenários são identificados pelo próprio Asaas antes da liquidação.

Motivo de recusa	Descrição
`PAYMENT_OVERDUE`	Cobrança vencida em razão da ausência de saldo ou limite no momento do débito.

Recusas retornadas pelo banco pagador

As recusas abaixo são retornadas pela instituição financeira responsável pela conta do pagador.

Motivo de recusa	Descrição
`EXTERNAL_INSTITUTION_ERROR`	Erro na instituição financeira do cliente.
`ACCOUNT_CLOSED`	Conta transacional do cliente encerrada.
`ACCOUNT_BLOCKED`	Conta transacional do cliente bloqueada.
`SAME_INSTITUTION_ERROR`	Não é possível solicitar agendamento para contas que utilizam o mesmo participante liquidante do SPI.
`MAXIMUM_AMOUNT_EXCEEDED`	Valor da cobrança superior ao limite definido pelo cliente.
`AMOUNT_MISMATCH`	Valor da cobrança diferente do valor previsto na recorrência.
`RECEIVER_CPF_CNPJ_MISMATCH`	CNPJ do recebedor divergente dos dados da recorrência.
`PAYER_CPF_CNPJ_MISMATCH`	CPF/CNPJ do pagador divergente dos dados da autorização.
`PARTICIPANT_NOT_REGISTERED`	Participante não cadastrado ou indisponível no SPI.
`DUE_DATE_MISMATCH`	Data de vencimento incompatível com as regras da recorrência.
`POST_DUE_DATE_ATTEMPT_NOT_ALLOWED`	Tentativa de agendamento realizada fora da janela permitida após o vencimento.
`RECEIVED_TOO_EARLY`	Solicitação recebida com antecedência superior a 10 dias da liquidação.
`RECEIVED_TOO_LATE`	Solicitação recebida com menos de 2 dias da liquidação.
`OTHER`	Erro desconhecido retornado pela instituição externa.
`OUT_OF_TIME_FRAME_FOR_RETRY`	A cobrança não permite novas tentativas após o vencimento.
`INVALID_RECURRING_PAYMENT_ID`	Identificador da recorrência inexistente ou inválido.
`RECURRING_PAYMENT_NOT_CONFIRMED`	A autorização da recorrência não foi confirmada pelo pagador.
`PAYMENT_ALREADY_SCHEDULED`	Já existe um pedido de liquidação pendente para a cobrança.
`PAYMENT_ALREADY_DONE`	A cobrança já foi liquidada.
`PAYMENT_INSTRUCTION_WITHOUT_AUTHORIZATION`	A instrução não possui uma autorização válida associada.
`EXCEEDED_MAXIMUM_RETRY_ATTEMPTS`	Quantidade máxima de tentativas após o vencimento foi excedida.
`PARTICIPANT_ISPB_INVALID`	ISPB da instituição financeira inválido ou inexistente.
`INVALID_CUSTOMER_CPF_CNPJ`	CPF/CNPJ inválido.
`INCORRECT_CUSTOMER_CPF_CNPJ`	CPF/CNPJ incorreto.

Comportamentos importantes

⚠️
Importante
Nem toda recusa é definitiva.
Algumas situações podem permitir novas tentativas, enquanto outras impedem definitivamente a liquidação da cobrança.

Por exemplo:

Falta de saldo ou limite pode permitir uma nova tentativa.
Cobranças já pagas não poderão ser processadas novamente.
Cancelamento ou ausência de autorização impede a criação de novas instruções.
Divergências cadastrais exigem correção dos dados antes de uma nova tentativa.

Exemplo de cenário

Uma cobrança recorrente é criada e a instrução é enviada ao banco do pagador.

Caso o cliente não possua saldo suficiente no momento da liquidação, poderá ocorrer:

PAYMENT_CREATED
↓
PIX_AUTOMATIC_RECURRING_PAYMENT_INSTRUCTION_CREATED
↓
PIX_AUTOMATIC_RECURRING_PAYMENT_INSTRUCTION_SCHEDULED
↓
PIX_AUTOMATIC_RECURRING_PAYMENT_INSTRUCTION_REFUSED

O motivo da recusa poderá ser identificado pelo código retornado no evento ou pela consulta da cobrança.

Boas práticas

📘
Recomendado

Armazene o código de recusa retornado.

Evite apresentar o código bruto ao usuário final.

Converta os códigos em mensagens amigáveis na sua aplicação.

Utilize webhooks para identificar recusas em tempo real.

Não considere toda recusa como erro permanente.

Sempre valide se a autorização do Pix Automático continua ativa.

Impactos operacionais

As recusas podem impactar diretamente o fluxo financeiro da integração.

Dependendo do motivo retornado:

a cobrança poderá permanecer pendente;
novas tentativas poderão ser realizadas;
poderá ser necessária uma ação do pagador;
poderá ser necessária correção cadastral;
cobranças futuras poderão deixar de ser processadas caso a autorização tenha sido cancelada ou expirada.

Por esse motivo, recomenda-se tratar os códigos de recusa de forma individualizada.

Próximos passos

Após implementar o tratamento das recusas, recomendamos consultar:

Fluxos de Webhook do Pix Automático.
Eventos do Pix Automático.
Autorizações do Pix Automático.
Cobranças recorrentes do Pix Automático.