Assinaturas no WooCommerce

Use o WooCommerce Subscriptions com o Plugin Asaas para receber cobranças recorrentes por boleto ou cartão de crédito.

O WooCommerce gerencia o ciclo de vida da assinatura, enquanto o Asaas gera e processa as cobranças conforme a periodicidade configurada.

Quando utilizar

Utilize assinaturas para produtos ou serviços com cobranças periódicas, como:

• mensalidades;
• clubes de assinatura;
• planos de serviço;
• cobranças recorrentes.

Para vendas únicas ou parcelamentos, consulte Formas de cobrança.

Antes de começar

Confirme que sua loja possui:

• Plugin Asaas instalado e configurado;
• WooCommerce instalado;
• WooCommerce Subscriptions instalado e ativo;
• API Key válida configurada;
• Webhooks funcionando normalmente.

Formas de pagamento compatíveis

Para revisar as configurações de boleto e cartão de crédito, consulte Formas de pagamentos.

Como funciona

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Cliente conclui a compra"] --> B["WooCommerce cria a assinatura"]
    B --> C["Plugin envia os dados ao Asaas"]
    C --> D["Registrar a assinatura"]
    D --> E["Gerar a cobrança do ciclo"]
    E --> F["Processar o pagamento"]
    F --> G["Atualizar o pedido via Webhook"]

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

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

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

A cada renovação, uma nova cobrança é criada automaticamente conforme a periodicidade da assinatura.

As cobranças continuam sendo geradas até que a assinatura seja cancelada ou atinja sua data de término, quando configurada.

Renovação das cobranças

Cada nova cobrança segue as configurações estabelecidas para a assinatura, incluindo:

• forma de pagamento;
• valor;
• juros;
• descontos;
• multas.

Utilize os Webhooks do plugin para acompanhar as atualizações das cobranças e dos pedidos, sem consultas periódicas.

Consulte os Webhooks do WooCommerce.

Cancelamento

Ao cancelar uma assinatura no WooCommerce:

• novas cobranças deixam de ser geradas;
• cobranças já existentes continuam seguindo suas próprias regras de pagamento;
• cobranças já pagas não são alteradas.

Valide a assinatura

Antes de operar em Produção, crie uma assinatura no Sandbox e confirme se:

• a assinatura é criada no WooCommerce;
• a assinatura é registrada no Asaas;
• a cobrança inicial é gerada;
• o pedido é atualizado após o pagamento;
• uma nova cobrança é criada na renovação.

Resultado esperado

A assinatura deve permanecer ativa durante o período configurado e gerar novas cobranças automaticamente a cada ciclo.

As mudanças de pagamento devem ser refletidas no WooCommerce por meio dos Webhooks.

Se apenas o pedido for criado

Se o WooCommerce criar o pedido, mas a assinatura não for processada corretamente, acesse:

WooCommerce > Configurações > Avançado > Recursos

Em seguida:

• habilite Armazenamento de postagens do WordPress (legado); ou
• ative o modo de compatibilidade, sincronize as assinaturas e realize um novo teste.

Se o problema continuar, consulte Erros comuns.

Limitações

Considere que:

• o WooCommerce Subscriptions é obrigatório;
• Pix não está disponível como forma de pagamento direta;
• a Compra com um Clique depende da liberação da tokenização pelo Asaas;
• em cenários de incompatibilidade com o armazenamento utilizado pelo WooCommerce, pode ser necessário utilizar o armazenamento legado ou o modo de compatibilidade.

Próximos passos

• Configure as formas de pagamento
• Entenda as formas de cobrança
• Consulte os Webhooks do WooCommerce
• Consulte os erros comuns
• Consulte o FAQ do WooCommerce