Conheça as Assinaturas

As Assinaturas automatizam a geração de cobranças recorrentes para um mesmo cliente.

Após criar a assinatura, o Asaas gera novas cobranças conforme a periodicidade configurada. Cada cobrança possui seu próprio ID, status e ciclo financeiro.

Quando utilizar

Utilize Assinaturas quando sua integração precisar:

• gerar cobranças em intervalos recorrentes;
• utilizar boleto, Pix ou cartão de crédito;
• automatizar mensalidades, planos ou serviços recorrentes;
• evitar a criação manual de uma nova cobrança a cada ciclo.

Como funciona

A assinatura funciona como uma programação para geração de cobranças.

%%{init: {"flowchart": {"nodeSpacing": 28,"rankSpacing": 32,"diagramPadding": 8,"padding": 10}}}%%
flowchart TD
    A["Cadastrar o cliente"] --> B["Criar a assinatura"]
    B --> C["Asaas gera as cobranças"]
    C --> D["Processar o pagamento"]
    D --> E["Receber os Webhooks"]
    E --> F["Atualizar a aplicação"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px,font-size:17px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px,font-size:17px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px,font-size:17px

    class A inicio
    class B,C,D,E validacao
    class F sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

As cobranças são geradas gradualmente conforme a recorrência. A criação da assinatura não gera todas as cobranças futuras de uma vez.

Por padrão, cada nova cobrança é criada 40 dias antes do vencimento. Esse prazo pode ser configurado para 14 ou 7 dias antes do vencimento.

Consulte como criar uma assinatura.

Escolha a forma de pagamento

Para cartão de crédito, os dados do cartão podem ser enviados na criação da assinatura para validação e utilização nas cobranças futuras.

Consulte Assinatura com cartão de crédito.

Acompanhe as cobranças geradas

Cada cobrança pertence à assinatura, mas possui seu próprio ciclo de vida.

Por isso, sua integração deve acompanhar novas cobranças e alterações de status por Webhooks, principalmente quando realizar:

• conciliação financeira;
• sincronização de cobranças;
• liberação de produtos ou serviços;
• emissão de notas fiscais.

Consulte os eventos de cobranças.

Recursos relacionados

Depois de implementar a recorrência, outros recursos podem complementar o fluxo:

Próximos passos

• Crie uma assinatura
• Crie uma assinatura com cartão de crédito
• Configure a emissão automática de notas fiscais
• Entenda o fluxo de bloqueio por divergência de Split
• Compare Pix Automático e Assinaturas
• Consulte o FAQ de Assinaturas