FAQ - Assinaturas

Esta seção reúne as principais dúvidas sobre a funcionalidade de Assinaturas do Asaas.

As Assinaturas permitem automatizar a geração de cobranças recorrentes para clientes, utilizando boleto bancário, Pix ou cartão de crédito, sem que seja necessário criar manualmente uma nova cobrança a cada período.

Além das perguntas mais frequentes, esta página apresenta comportamentos importantes, limitações e recomendações para utilização da funcionalidade.

Regras importantes das Assinaturas

Antes de utilizar este recurso, considere que:

• é necessário possuir um cliente previamente cadastrado;
• uma assinatura apenas agenda a criação das cobranças recorrentes;
• as cobranças são criadas automaticamente pelo Asaas;
• o pagamento ocorre através das cobranças geradas, e não da assinatura em si;
• alterações na assinatura normalmente afetam apenas cobranças futuras;
• cobranças já criadas permanecem inalteradas, salvo quando permitido através de parâmetros específicos da API.

O que é uma assinatura?

Uma assinatura é um recurso utilizado para automatizar cobranças recorrentes.

Ao criar uma assinatura, o Asaas passa a gerar automaticamente novas cobranças conforme a periodicidade configurada, eliminando a necessidade de criar manualmente cada cobrança.

Quais formas de pagamento são suportadas?

As assinaturas podem utilizar:

• boleto bancário;
• Pix;
• cartão de crédito.

Quando a forma de pagamento for cartão de crédito, os débitos ocorrerão automaticamente nas datas previstas, desde que o cartão permaneça válido.

Qual a diferença entre assinatura e parcelamento?

Embora ambos dividam pagamentos em vários períodos, o comportamento é diferente.

Parcelamento

Todas as parcelas são criadas imediatamente.

Criar parcelamento
        ↓
Todas as parcelas são criadas

Assinatura

As cobranças são criadas gradualmente conforme a recorrência.

Criar assinatura
        ↓
Asaas cria cada nova cobrança
automaticamente

Por esse motivo, assinaturas são recomendadas para cobranças contínuas, enquanto parcelamentos são indicados para dividir uma compra única.

Quando as cobranças são criadas?

Por padrão, as cobranças de uma assinatura são geradas 40 dias antes do vencimento (nextDueDate da recorrência correspondente).

Esse comportamento permite que notificações, webhooks e demais processos ocorram antes da data efetiva de vencimento.

Caso necessário, esse prazo pode ser alterado para 14 ou 7 dias antes do vencimento mediante configuração da conta.

A assinatura realiza o pagamento automaticamente?

Depende da forma de pagamento.

Cartão de crédito

Sim.

O Asaas realiza automaticamente a tentativa de cobrança na data de vencimento.

Pix e boleto

Não.

Uma nova cobrança será criada automaticamente e caberá ao cliente realizar o pagamento normalmente.

Posso alterar uma assinatura?

Sim.

É possível alterar informações como:

• valor;
• vencimento;
• descrição;
• periodicidade;
• forma de pagamento (quando permitido).

As alterações normalmente serão aplicadas apenas às próximas cobranças.

Como atualizar também as cobranças pendentes?

Ao atualizar uma assinatura, é possível informar o parâmetro:

updatePendingPayments = true

Quando utilizado, as cobranças pendentes ainda não pagas também poderão ser atualizadas com as novas configurações da assinatura.

Caso contrário, apenas as futuras cobranças utilizarão os novos dados.

Posso alterar o cartão de crédito utilizado?

Sim.

Existe um endpoint específico para atualização do cartão de crédito da assinatura.

Essa operação atualiza apenas o cartão utilizado nas próximas cobranças e não realiza uma cobrança imediata.

O cartão é cobrado no momento da criação da assinatura?

Não necessariamente.

Durante a criação da assinatura, o cartão é validado.

A cobrança ocorrerá apenas na data definida em nextDueDate.

Caso deseje cobrar imediatamente, basta utilizar a data atual como primeiro vencimento.

O que acontece se o cartão vencer ou for cancelado?

As próximas tentativas de cobrança poderão falhar normalmente.

Nesses casos, recomenda-se atualizar o cartão cadastrado antes do próximo vencimento para evitar interrupções na recorrência.

Como saber quando uma cobrança foi criada?

As cobranças geradas pela assinatura enviam normalmente os eventos de webhook da API de cobranças.

O primeiro evento recebido costuma ser:

PAYMENT_CREATED

Esse evento contém o identificador da assinatura responsável pela cobrança.

Como saber quando uma cobrança foi paga?

O pagamento deve ser acompanhado através dos eventos de webhook da cobrança.

Alguns exemplos:

• PAYMENT_RECEIVED;
• PAYMENT_OVERDUE;
• PAYMENT_REFUNDED;
• PAYMENT_DELETED.

A assinatura permanece ativa independentemente do pagamento de uma cobrança específica, salvo quando removida ou cancelada.

Posso consultar todas as cobranças da assinatura?

Sim.

Existe um endpoint específico para listar todas as cobranças já criadas para uma assinatura.

Esse recurso permite acompanhar:

• cobranças pendentes;
• cobranças pagas;
• cobranças vencidas;
• cobranças canceladas.

Posso emitir notas fiscais automaticamente?

Sim.

É possível configurar a emissão automática de notas fiscais para cada cobrança gerada pela assinatura.

A emissão poderá ocorrer:

• após o pagamento;
• no vencimento;
• antes do vencimento;
• no início do mês;
• no mês seguinte,

conforme a configuração realizada.

Posso utilizar Split de Pagamentos?

Sim.

As cobranças geradas por uma assinatura podem utilizar Split de Pagamentos.

Caso o valor configurado para o split seja superior ao valor líquido da cobrança, a assinatura poderá ser bloqueada automaticamente até que a divergência seja corrigida.

O que acontece quando ocorre divergência de Split?

Quando o valor destinado aos participantes do split ultrapassa o valor líquido disponível, o Asaas:

• bloqueia temporariamente a assinatura;
• interrompe a criação de novas cobranças;
• envia uma notificação via Webhook.

Após a correção do split ou do valor da assinatura, o fluxo poderá ser normalizado.

Posso cancelar uma assinatura?

Sim.

Ao remover uma assinatura:

• novas cobranças deixam de ser criadas;
• cobranças já existentes permanecem disponíveis e continuam seguindo seu fluxo normalmente.

Caso também seja necessário cancelar cobranças pendentes, essa operação deverá ser realizada separadamente.

Quais são os erros mais comuns?

Cliente inexistente

Ocorre quando o identificador informado não pertence a um cliente válido.

Forma de pagamento incompatível

Algumas configurações dependem da forma de pagamento escolhida.

Cartão inválido

Pode ocorrer durante a validação inicial do cartão ou nas cobranças futuras.

Atualização não refletida

Normalmente acontece porque apenas cobranças futuras são atualizadas.

Caso seja necessário atualizar cobranças pendentes, utilize updatePendingPayments.

Assinatura bloqueada por divergência de Split

Ocorre quando o valor distribuído pelo split ultrapassa o valor líquido disponível para recebimento.

Boas práticas

Conteúdos relacionados

• Introdução às Assinaturas.
• 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.
• Diferença entre Pix Automático e Assinaturas.
• Webhooks para Cobranças.