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_UPDATEDNesse evento, o campo:
eligibility.statuspassará a possuir o valor:
INELIGIBLEQuando 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.
