Introdução - assinaturas
Comece com Assinaturas
As Assinaturas permitem gerar cobranças recorrentes para um mesmo cliente conforme uma periodicidade definida.
O Asaas cria as novas cobranças ao longo da recorrência. Cada cobrança possui seu próprio ID, status e ciclo financeiro.
Quando utilizar
Utilize Assinaturas quando sua integração precisar:
- gerar cobranças periodicamente para o mesmo cliente;
- utilizar boleto, Pix ou cartão de crédito;
- definir a periodicidade da recorrência;
- deixar o Asaas responsável pela geração das próximas cobranças.
Escolha o modelo adequado
| Necessidade | Utilize |
|---|---|
| Gerar novas cobranças periodicamente | Assinaturas |
| Dividir uma única compra em várias parcelas | Cobrança parcelada |
| Realizar débitos recorrentes via Pix após autorização do pagador | Pix Automático |
Assinatura e parcelamento não representam o mesmo fluxo. No parcelamento, as parcelas pertencem a uma única operação. Na assinatura, novas cobranças são geradas ao longo da recorrência.
Antes de começar
Defina:
- o cliente que será cobrado;
- a forma de pagamento;
- o valor;
- a periodicidade;
- a data do primeiro vencimento.
Cadastre o cliente antes de criar a assinatura e armazene seu ID.
Consulte: o Cadastro de clientes.
Como funciona
Após criar a assinatura, o Asaas gera novas cobranças conforme a recorrência configurada.

As cobranças futuras não são criadas todas de uma vez. Cada cobrança é gerada conforme as regras da recorrência e deve ser acompanhada individualmente.
Para entender prazos de geração, alterações, cancelamento e comportamento das cobranças já criadas, consulte Assinaturas (recorrência).
Escolha como implementar
| Objetivo | Conteúdo |
|---|---|
| Criar uma assinatura com boleto ou Pix | Criando uma assinatura |
| Criar uma assinatura com cartão de crédito | Criando assinatura com cartão de crédito |
| Emitir notas fiscais para cobranças recorrentes | Emitir notas fiscais automaticamente para assinaturas |
| Utilizar Split nas cobranças da assinatura | Fluxo de bloqueio por divergência de Split |
| Comparar Assinaturas com Pix Automático | Diferença entre Pix Automático e Assinaturas |
| Consultar comportamentos específicos | FAQ de Assinaturas |
Acompanhe as cobranças
A criação da assinatura não confirma o recebimento.
Acompanhe as cobranças geradas e seus respectivos status por Webhook. O objeto da cobrança informa a assinatura de origem no campo subscription.
Consulte os: Eventos para cobranças.
Próximos passos
Updated 4 days ago
