FAQ do Pix Automático

Veja aqui respostas para dúvidas comuns na implementação e gestão dos Pix automáticos.

Esta seção reúne as principais dúvidas sobre o Pix Automático no Asaas.

O Pix Automático permite automatizar cobranças recorrentes por meio de uma autorização concedida pelo pagador. Após a autorização ser ativada, novas cobranças podem ser criadas periodicamente pela API e debitadas automaticamente na data de vencimento, conforme as regras definidas pelo Banco Central.

Além das perguntas frequentes, esta página apresenta comportamentos importantes da funcionalidade, limitações e boas práticas para implementação.


1. O que acontece se o meu cliente pagar a cobrança antes do vencimento?

Se o pagamento da cobrança ocorrer até o dia anterior ao vencimento, a instrução automática referente àquele ciclo será cancelada para evitar um débito em duplicidade.

Isso não encerra o Pix Automático. A autorização permanece ativa e a próxima cobrança poderá ser criada normalmente para o ciclo seguinte.


2. O Asaas gera automaticamente as cobranças mensais?

Não.

Após o pagamento da primeira cobrança e a ativação da autorização do Pix Automático, o pagador não precisa mais realizar novas autorizações.

Entretanto, o Asaas não cria automaticamente as cobranças recorrentes.

Sua aplicação deve criar uma nova cobrança via API a cada ciclo (mensal, semanal ou conforme a periodicidade adotada), informando o identificador da autorização.

Uma vez criada a cobrança, o débito será executado automaticamente na data de vencimento, desde que a autorização continue ativa e existam recursos suficientes na conta do pagador.


3. Posso utilizar Split de Pagamentos com Pix Automático?

Depende da etapa do fluxo.

  • Na criação da autorização (QR Code inicial): não é possível utilizar Split de Pagamentos.
  • Nas cobranças recorrentes criadas posteriormente: sim. O Split pode ser informado normalmente ao criar a cobrança utilizando a API de cobranças.

Esse comportamento existe porque a autorização inicial possui regras específicas definidas pelo modelo operacional do Pix Automático.


4. O que acontece se o cliente não possuir saldo suficiente no vencimento?

Caso não exista saldo ou limite disponível, o banco do pagador realizará novas tentativas de débito durante a janela operacional prevista pelo Banco Central.

Se nenhuma tentativa for concluída com sucesso, a cobrança mudará para o status OVERDUE, sendo enviado normalmente o evento PAYMENT_OVERDUE.


5. Como funcionam as retentativas em caso de falta de saldo?

A primeira tentativa de débito ocorre às 7h.

Caso não exista saldo disponível, novas tentativas poderão ocorrer ao longo do mesmo dia, conforme o fluxo operacional definido pelo Banco Central.

Atualmente, as tentativas ocorrem aproximadamente nos seguintes horários:

  • 7h
  • 10h
  • 13h
  • 16h
  • 18h
  • 19h
  • 20h

Caso todas as tentativas falhem, a instrução será recusada definitivamente após a última tentativa do dia.

Não são realizadas novas tentativas nos dias posteriores.


6. Posso alterar o valor das cobranças recorrentes?

Depende da forma como a autorização foi criada.

Quando o campo value é enviado na criação da autorização, ele passa a representar um valor fixo para toda a recorrência.

Nesse cenário, as cobranças futuras deverão respeitar esse valor.

Quando a autorização é criada sem informar o campo value, cada nova cobrança poderá definir livremente seu próprio valor.

Esse comportamento é indicado para cobranças variáveis, como consumo, mensalidades variáveis ou serviços públicos.

Caso seja necessário alterar um valor fixo previamente definido, será necessário cancelar a autorização existente e criar uma nova autorização.


7. Quais são os requisitos para utilizar o Pix Automático?

Para utilizar o Pix Automático no Asaas, a conta deve atender aos critérios de elegibilidade.

Entre os principais requisitos estão:

  • possuir conta Pessoa Jurídica (CNPJ);
  • estar aprovada;
  • não possuir pendências cadastrais;
  • possuir CNPJ ativo na Receita Federal;
  • possuir CNPJ ativo há pelo menos seis meses;
  • não possuir restrições relacionadas à utilização do Pix.

Caso algum requisito deixe de ser atendido, a conta poderá se tornar inelegível para novas autorizações.


8. O que acontece se uma conta deixar de ser elegível?

Quando uma conta deixa de atender aos critérios de elegibilidade, é enviado o evento:

PIX_AUTOMATIC_RECURRING_ELIGIBILITY_UPDATED

Nesse evento, o campo:

eligibility.status

passará a possuir o valor:

INELIGIBLE

Quando isso ocorre:

  • todas as autorizações ativas são canceladas;
  • todas as instruções de pagamento vinculadas também são canceladas;
  • novas cobranças automáticas deixam de ser processadas.

Ao receber esse evento, recomenda-se atualizar imediatamente o status das cobranças vinculadas na aplicação.


Boas práticas

📘

Recomendado

  • Armazene o identificador da autorização para reutilizá-lo nas cobranças futuras.
  • Utilize Webhooks para acompanhar alterações de status das autorizações e cobranças.
  • Trate os eventos recebidos de forma idempotente.
  • Não considere apenas a resposta síncrona da API para determinar o estado final da cobrança.
  • Monitore eventos de elegibilidade para evitar tentativas de cobrança em contas inelegíveis.

Conteúdos relacionados

  • Pix Automático.
  • Implementação do Pix Automático.
  • Fluxos de Webhook do Pix Automático.
  • Motivos de Recusa.
  • Criar autorização do Pix Automático.
  • Criar cobrança com Pix Automático.
  • Configuração de Webhooks.