FAQ de Assinaturas

Consulte os principais comportamentos das Assinaturas, desde a geração das cobranças até alterações, Webhooks, cartão de crédito, Split e encerramento da recorrência.

Qual a diferença entre assinatura e parcelamento?

Uma assinatura gera novas cobranças ao longo do tempo conforme a periodicidade configurada.

No parcelamento, as parcelas pertencem a uma única operação e são criadas como parte daquele parcelamento.

Utilize Assinaturas para cobranças contínuas. Utilize parcelamento quando precisar dividir uma única cobrança em parcelas.

Quais formas de pagamento são suportadas?

As Assinaturas podem utilizar:

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

O comportamento do pagamento depende da forma escolhida.

Quando as cobranças são geradas?

Por padrão, cada cobrança da assinatura é criada 40 dias antes do vencimento.

Esse prazo pode ser configurado na conta para:

• 14 dias antes;
• 7 dias antes.

As cobranças futuras não são criadas todas no momento da criação da assinatura. Elas são geradas gradualmente conforme a recorrência.

Consulte Assinaturas (recorrência).

O pagamento acontece automaticamente?

Depende da forma de pagamento.

A criação da assinatura não representa a confirmação de um pagamento.

O cartão é cobrado ao criar a assinatura?

Normalmente, não.

Na criação de uma assinatura com cartão de crédito, o cartão é validado e utilizado nas cobranças futuras.

A primeira cobrança ocorre em nextDueDate. Se nextDueDate corresponder à data atual, a cobrança poderá ser processada imediatamente.

Consulte Criando assinatura com cartão de crédito.

Posso alterar uma assinatura?

Sim.

É possível atualizar configurações como valor, periodicidade, vencimento, forma de pagamento e status:

PUT /v3/subscriptions/{id}

Por padrão, as alterações são aplicadas às cobranças futuras.

Para aplicar alterações suportadas também às cobranças pendentes já geradas, envie:

{
  "updatePendingPayments": true
}

Consulte o endpoint Atualizar assinatura existente.

Posso alterar o cartão de crédito?

Sim.

Utilize o endpoint específico:

PUT /v3/subscriptions/{id}/creditCard

A operação não realiza uma cobrança imediata.

O novo cartão passa a ser utilizado pela assinatura e também pelas cobranças pendentes vinculadas a ela.

Consulte o endpoint Atualizar cartão de crédito da assinatura.

Como acompanhar a assinatura e suas cobranças?

Utilize dois grupos de Webhooks:

• Eventos de assinaturas: acompanham criação, atualização, inativação, remoção e comportamentos relacionados ao Split;
• Eventos de cobranças: acompanham cada cobrança gerada e seu ciclo financeiro.

Quando uma cobrança da assinatura é criada, o evento PAYMENT_CREATED contém o campo subscription, que permite identificar a recorrência de origem.

Consulte os Eventos para assinaturas.

Consulte os Eventos para cobranças.

Posso consultar as cobranças de uma assinatura?

Sim.

Utilize:

GET /v3/subscriptions/{id}/payments

O endpoint retorna apenas cobranças que já foram geradas. Cobranças futuras ainda não aparecem na listagem.

Consulte o endpoint Listar cobranças de uma assinatura.

Posso emitir notas fiscais automaticamente?

Sim.

É possível configurar a emissão automática de NFS-e para as cobranças da assinatura e definir quando cada nota deve ser emitida.

Consulte Emitir notas fiscais automaticamente para assinaturas.

Posso utilizar Split de Pagamentos?

Sim.

O Split configurado na assinatura funciona como um template para as novas cobranças da recorrência.

Se o valor destinado ao Split ultrapassar o valor líquido disponível, a assinatura pode ser bloqueada e deixar de gerar novas cobranças até a regularização ou o encerramento do bloqueio.

Consulte o Fluxo de bloqueio por divergência de Split.

Posso interromper uma assinatura temporariamente?

Sim.

Atualize o status para:

INACTIVE

Enquanto estiver inativa, a assinatura não gera novas cobranças. As cobranças já existentes permanecem inalteradas.

Para reativar, altere o status para ACTIVE e informe um novo nextDueDate.

Consulte o endpoint Atualizar assinatura existente.

O que acontece ao remover uma assinatura?

A remoção encerra definitivamente a recorrência:

DELETE /v3/subscriptions/{id}

Novas cobranças deixam de ser geradas.

Além disso, o Asaas remove as cobranças pendentes ou vencidas que ainda pertencem à assinatura.

Se a intenção for interromper a recorrência apenas temporariamente, utilize status = INACTIVE em vez de remover a assinatura.

Consulte o endpoint Remover assinatura.

Próximos passos

• Crie uma assinatura
• Crie uma assinatura com cartão de crédito
• Acompanhe os eventos de assinaturas
• Acompanhe os eventos de cobranças
• Configure a emissão automática de notas fiscais
• Entenda o bloqueio por divergência de Split