Introdução - assinaturas

As assinaturas permitem automatizar a geração de cobranças recorrentes para um mesmo cliente, eliminando a necessidade de criar manualmente uma nova cobrança a cada período.

Essa funcionalidade é indicada para modelos de negócio que realizam cobranças periódicas, como mensalidades, planos de assinatura, aluguéis, academias, escolas e serviços recorrentes em geral.

Além da recorrência mensal, o Asaas também permite utilizar outras periodicidades, como semanal, quinzenal, trimestral, semestral e anual.

Quando utilizar

As assinaturas são recomendadas quando sua integração precisa gerar cobranças automaticamente em intervalos regulares para um mesmo cliente.

Alguns exemplos incluem:

• mensalidades de academias;
• assinaturas de softwares (SaaS);
• planos de serviços;
• aluguel;
• clubes de assinatura;
• cobranças recorrentes em geral.

Pré-requisitos

Antes de criar uma assinatura, é necessário:

• possuir um cliente previamente cadastrado;
• definir a forma de pagamento da recorrência;
• configurar a periodicidade da assinatura;
• informar a primeira data de vencimento da recorrência.

Dependendo da forma de pagamento utilizada, poderão existir requisitos adicionais, como os dados do cartão de crédito para assinaturas nessa modalidade.

Principais parâmetros da assinatura

Alguns campos influenciam diretamente o comportamento da recorrência:

• customer — cliente ao qual a assinatura pertence;
• billingType — forma de pagamento utilizada na recorrência;
• cycle — periodicidade das cobranças;
• value — valor da recorrência;
• nextDueDate — primeira data de vencimento da assinatura;
• endDate — data final da recorrência, quando aplicável;
• description — descrição utilizada nas cobranças geradas.

Diferença entre assinaturas e parcelamentos

Embora ambos permitam dividir pagamentos ao longo do tempo, seus comportamentos são diferentes.

Nas cobranças parceladas, todas as parcelas são criadas imediatamente após a criação da cobrança.

Já nas assinaturas, novas cobranças são geradas automaticamente conforme a periodicidade definida.

Além disso, existe uma diferença importante para pagamentos com cartão de crédito:

• no parcelamento, todo o valor da compra é lançado imediatamente no cartão do cliente, sendo parcelado pela operadora;
• na assinatura, uma nova transação é criada a cada recorrência até que a assinatura seja encerrada ou o cartão deixe de ser válido.

Esse comportamento torna as assinaturas mais adequadas para cobranças contínuas.

Fluxo de criação das cobranças

As cobranças pertencentes a uma assinatura são geradas automaticamente antes do vencimento configurado.

Por padrão, o Asaas cria novas cobranças 40 dias antes da data informada no campo nextDueDate, permitindo que notificações, integrações e processos internos ocorram com antecedência.

Fluxo simplificado:

Criar assinatura
        ↓
Asaas gera
novas cobranças
automaticamente
        ↓
Cliente realiza
o pagamento
        ↓
Webhook informa
o resultado

Caso a conta utilize a configuração padrão de envio de notificações (10 dias antes do vencimento), apenas a primeira cobrança terá sua notificação enviada imediatamente.

As notificações das cobranças futuras serão enviadas somente quando cada cobrança atingir a antecedência configurada.

Prazo de geração das cobranças

Por padrão, novas cobranças são geradas 40 dias antes do vencimento.

Caso necessário, esse prazo pode ser alterado para:

• 14 dias antes;
• 7 dias antes.

Essa configuração é aplicada à conta e pode ser solicitada ao Gerente de Contas.

Regras importantes

Durante a utilização das assinaturas, considere que:

• novas cobranças são criadas automaticamente conforme a periodicidade;
• alterar uma assinatura impacta apenas as cobranças futuras, salvo indicação em contrário;
• cobranças já criadas continuam seguindo seu próprio ciclo financeiro;
• cancelar uma assinatura impede apenas a geração de novas cobranças, não removendo automaticamente cobranças já existentes.

Impactos operacionais

Como novas cobranças são geradas automaticamente ao longo do tempo, integrações que realizam:

• sincronização de cobranças;
• conciliação financeira;
• emissão automática de notas fiscais;
• processamento de Webhooks;
• geração de relatórios;

devem considerar que novas cobranças poderão surgir sem necessidade de novas chamadas de criação pela API.

Por esse motivo, recomenda-se utilizar Webhooks para acompanhar o ciclo de vida das cobranças geradas pela assinatura.

Boas práticas

Próximos passos

Após compreender o funcionamento das assinaturas, recomendamos consultar:

• Criando uma assinatura.
• Criando assinatura com cartão de crédito.
• Emitir notas fiscais automaticamente para assinaturas.
• Fluxo de bloqueio de assinatura por divergência de Split.
• FAQ de Assinaturas.
• Pix Automático x Assinaturas.