Guia de Assinaturas

Confira o guia de assinaturas para mais informações.

Endpoint responsável por remover uma assinatura existente, encerrando sua recorrência e impedindo a geração de novas cobranças.

Além da remoção da assinatura, o Asaas também remove as cobranças pendentes ou vencidas que ainda pertencem a essa recorrência, evitando que novas cobranças sejam enviadas ao pagador.

Quando utilizar

Utilize este endpoint quando sua integração precisar:

• cancelar definitivamente uma assinatura;
• encerrar a recorrência solicitada pelo cliente;
• interromper a geração automática de novas cobranças;
• remover uma assinatura criada incorretamente;
• substituir uma assinatura por outra com novas configurações.

Caso a intenção seja interromper temporariamente a recorrência, recomenda-se utilizar o endpoint Atualizar assinatura, alterando o status para INACTIVE.

Parâmetro importante

Este endpoint utiliza apenas um parâmetro obrigatório:

• id — identificador único da assinatura no Asaas.

Esse identificador é retornado no momento da criação da assinatura e deve ser armazenado pela sua aplicação.

Regras de negócio importantes

Ao remover uma assinatura:

• novas cobranças deixam de ser ser geradas;
• cobranças pendentes ou vencidas pertencentes à assinatura são removidas;
• cobranças já pagas permanecem registradas para preservar o histórico financeiro;
• a assinatura deixa de participar dos fluxos recorrentes da integração.

A remoção atua apenas sobre a assinatura informada.

Como funciona

Fluxo simplificado:

Assinatura ativa
        ↓
Solicitação de remoção
        ↓
Assinatura removida
        ↓
Cobranças pendentes ou vencidas removidas
        ↓
Nenhuma nova cobrança será gerada

Comportamentos importantes

Após a remoção:

• a assinatura não poderá mais gerar novas cobranças;
• cobranças futuras deixam de existir;
• cobranças já liquidadas permanecem disponíveis para consulta;
• Webhooks relacionados às cobranças já existentes poderão continuar sendo recebidos caso eventos tenham sido gerados antes da remoção.

Boas práticas

Erros comuns

400 Bad Request

Pode ocorrer quando o identificador informado possui formato inválido.

401 Unauthorized

Ocorre quando a API Key é inválida ou pertence a outro ambiente.

404 Not Found

Ocorre quando a assinatura informada não existe ou não pertence à conta autenticada.

Impactos operacionais

A remoção interrompe definitivamente o ciclo de geração das cobranças recorrentes.

Caso sua aplicação possua processos de faturamento, conciliação financeira, notificações automáticas ou integrações com sistemas externos, recomenda-se atualizar imediatamente o status interno da assinatura para evitar novas tentativas de cobrança ou inconsistências entre os sistemas.

Conteúdos relacionados

• Criar assinatura
• Atualizar assinatura
• Recuperar uma única assinatura
• Listar assinaturas
• Listar cobranças de uma assinatura
• Webhooks de assinatura