O Pix Automático permite realizar cobranças recorrentes debitadas automaticamente da conta do cliente, após a autorização inicial. Para utilizar o recurso, a sua conta precisa ter os seguintes requisitos:
Tipo de conta: Pessoa Jurídica (PJ).
Tempo de empresa: CNPJ ativo há pelo menos 6 meses na Receita Federal.
Status no Asaas: Conta Asaas com cadastro totalmente aprovado.
Segurança e conformidade: Sem indícios de fraude ou infrações registradas no DICT (Diretório de Identificadores de Contas Transacionais).
Atividade econômica: CNAE compatível com modelos de cobrança recorrente.
Chave Pix ativa: Ter ao menos uma chave Pix cadastrada na sua conta Asaas.
Fluxo de autorização e cobrança:
-
Crie a autorização do Pix Automático via API:
-
É a criação da autorização que gera o primeiro QR Code dinâmico para o pagador. Nela, você define como as cobranças dos próximos ciclos serão geradas (paymentCreationMode):
SUBSCRIPTION: O Asaas gera as cobranças automaticamente a cada ciclo.
MANUAL: Sua própria aplicação agenda e envia cada cobrança via API.
-
Envie o primeiro QR Code gerado para o pagador.
Aguarde o pagador aprovar a autorização no aplicativo do banco dele durante o pagamento desse primeiro QR Code.
Acompanhe as cobranças seguintes, que passam a ser debitadas automaticamente.
Dica para desenvolvedores: Você pode simular e homologar suas integrações no ambiente de Sandbox antes de ir para produção. Para habilitar os cenários de teste, acesse: Menu do usuário > Minha conta > Configurações > Sandbox.
Erro invalid_action
Se a API retornar o erro invalid_action com a mensagem "Você não possui permissão para utilizar este recurso. Entre em contato com seu gerente de contas", as causas mais prováveis e os passos para regularizar são:
-
Conta ainda não habilitada ou não elegível:
Confira se o seu cadastro cumpre todos os requisitos de elegibilidade listados acima (CNPJ ativo há 6+ meses, conta aprovada, CNAE compatível). Por se tratar de uma liberação gradual, a funcionalidade pode ainda não ter sido ativada para o seu perfil.
-
Falta de chave Pix cadastrada:
-
A API exige uma chave Pix ativa na conta para validar as chamadas do recurso.
Vá em Menu do usuário > Minha conta > Chaves Pix.
Cadastre uma chave Pix (caso ainda não possua) e tente realizar a requisição novamente.
-
Caso sua empresa atenda aos critérios, a chave Pix já esteja cadastrada e o erro persista, entre em contato com o suporte.
Saiba mais em: https://docs.asaas.com/reference/pix-autom%C3%A1tico