O módulo de Assinaturas da Uappi permite que seus clientes comprem produtos de forma recorrente, sem precisar realizar uma nova compra manualmente a cada período.
No momento da contratação, o cliente escolhe um dos intervalos de recorrência disponibilizados pela loja. Após a aprovação do pedido inicial, a assinatura é ativada e os próximos pedidos passam a ser gerados automaticamente, conforme o intervalo escolhido.
Neste conteúdo, você vai entender como funciona todo o ciclo de uma assinatura, desde a contratação até a geração dos pedidos recorrentes.
Para disponibilizar a assinatura aos clientes, é necessário que:
Importante: as cobranças recorrentes são realizadas por cartão de crédito. PIX e boleto não são utilizados para as próximas cobranças da assinatura.
Acesse:
Configurações > Módulos > Assinaturas > Configurações
Certifique-se de que o módulo está ativo e que a opção para permitir novas assinaturas está habilitada.
Também devem ser cadastrados os intervalos de recorrência que poderão ser escolhidos pelo cliente, como 30, 60 ou 90 dias.
Além da configuração geral do módulo, cada produto que poderá ser contratado de forma recorrente precisa permitir assinatura.
Essa configuração pode ser realizada no cadastro individual do produto ou por meio das opções de edição em massa disponíveis em Produtos.
No produto, configure:
Permitir assinatura = Sim
Atenção: ativar somente o módulo não faz com que todos os produtos da loja sejam disponibilizados automaticamente para assinatura.
Acesse:
Configurações > Pagamento
Um conector de cartão de crédito compatível com cobranças recorrentes deve estar associado ao campo Assinatura.
Importante: em conectores WAPI, como o Pagar.me v5, o conector somente fica disponível no campo Assinatura quando o processamento de pedidos via API está habilitado.
Quando um produto permite assinatura, o cliente pode selecionar no checkout a recorrência desejada, de acordo com os intervalos disponibilizados pela loja.
Por exemplo:
Receber a cada 30 dias.
O primeiro pedido é realizado normalmente utilizando cartão de crédito.
No exemplo acima, o cliente pode escolher entre os períodos de recorrência disponibilizados pela loja, como a cada 15 ou 30 dias.
Após selecionar a recorrência, o primeiro pedido é realizado normalmente utilizando cartão de crédito.
Após a contratação:
A partir daí, os próximos pedidos são gerados automaticamente de acordo com a recorrência contratada.
O produto contratado permanece o mesmo durante a assinatura. O cliente pode alterar informações permitidas pela loja, como cartão e endereço, mas não pode substituir o produto por outro.
Quando a assinatura envolve um Produto Conjunto, a composição escolhida no momento da contratação também é mantida nos próximos pedidos.
Veja também:
Como configurar assinatura para Produto Conjunto
De forma resumida, o fluxo funciona assim:
Contratação → Pedido de origem → Pagamento → Assinatura ativa → Próxima recorrência → Novo pedido → Próxima recorrência
A assinatura continua nesse ciclo enquanto estiver ativa e todas as validações necessárias para gerar os novos pedidos forem concluídas com sucesso.
Durante seu ciclo, uma assinatura pode apresentar os seguintes status:
| Status | O que significa |
| Pendente | A assinatura foi criada, mas o pedido de origem ainda não foi pago. |
| Ativo | A assinatura está em andamento e pode gerar novos pedidos. |
| Pausado | A geração de novos pedidos está interrompida. A assinatura pode ser reativada. |
| Falha ao gerar pedido | A tentativa de gerar um pedido recorrente não foi concluída. Novas tentativas podem ocorrer conforme a configuração da loja. |
| Cancelamento solicitado | O cliente solicitou o cancelamento e a loja precisa concluir a ação. |
| Cancelado | A assinatura foi encerrada definitivamente e não gera mais pedidos. |
Algumas situações relacionadas aos pedidos também podem alterar automaticamente a assinatura:
Na data programada para a próxima recorrência, a Uappi verifica as assinaturas com status Ativo ou Falha ao gerar pedido.
Essa verificação acontece nos horários definidos nas configurações do módulo.
Antes de criar o novo pedido, a plataforma verifica:
Quando todas as validações são concluídas com sucesso, um novo pedido é criado.
Em seguida:
Caso a comunicação esteja habilitada, o cliente também recebe o e-mail referente à recorrência.
Se o cliente estiver inativo ou tiver sido excluído, a assinatura é cancelada.
Se alguma validação ou cobrança impedir a geração do pedido, a assinatura passa para:
Falha ao gerar pedido
Nesse cenário:
A plataforma continuará realizando novas tentativas até atingir o limite configurado.
Quando o limite de retentativas é atingido, a assinatura passa para Pausado.
Se a quantidade de retentativas estiver configurada como 0, a assinatura será pausada já na primeira falha automática.
A loja pode acompanhar essas ocorrências em:
Pedidos > Assinatura
Depois da contratação, o cliente pode acessar sua assinatura pela área logada da loja.
Nessa área, é possível consultar informações como:
As ações disponíveis para o cliente dependem das permissões definidas pela loja nas configurações do módulo.
Entre elas, podem estar:
Caso a loja utilize a opção de cancelamento via solicitação, o cancelamento não acontece imediatamente.
Quando o cliente solicita o cancelamento:
Atenção: o cancelamento é definitivo. Depois de cancelada, a assinatura não pode ser reativada e deixa de gerar novos pedidos.
Para acompanhar as assinaturas, acesse:
Pedidos > Assinatura
Na listagem, é possível localizar e filtrar assinaturas, inclusive pelo status.
Ao acessar uma assinatura, a loja pode consultar informações como:
Enquanto a assinatura não estiver cancelada, a loja também pode realizar alterações permitidas, como:
Os pedidos gerados por aquela assinatura também podem ser acessados pela própria listagem.
Quando existem assinaturas com status de Cancelamento solicitado, o menu de Pedidos apresenta um alerta para que a loja possa identificar e tratar essas solicitações.
A regra utilizada nos pedidos recorrentes é definida em:
Configurações > Módulos > Assinaturas > Preços
A loja pode trabalhar com duas formas de cobrança:
Cada novo pedido considera o preço atual do produto na loja.
Por isso, caso o preço seja alterado após a contratação, o valor da próxima recorrência também poderá mudar.
Quando essa opção é utilizada, o checkout pode informar ao cliente que o preço está sujeito a alterações.
Mantém nas próximas recorrências o preço utilizado no momento em que a assinatura foi contratada.
Também é possível configurar:
Antes de disponibilizar assinaturas na loja, considere as seguintes regras:
Depois que o pedido de origem fica com status Pago ou Faturado. Antes disso, a assinatura permanece como Pendente.
Não. O produto contratado é mantido durante as próximas recorrências.
Caso o cliente queira receber outro produto, será necessário realizar uma nova assinatura.
Não. As cobranças recorrentes são realizadas utilizando o cartão de crédito salvo.
A assinatura passa para Falha ao gerar pedido e a plataforma realiza novas tentativas de acordo com o limite configurado pela loja.
Quando o limite é atingido, a assinatura é pausada.
Caso essa permissão esteja habilitada, o cliente pode acessar a Minha Conta e alterar o cartão.
Depende da configuração utilizada pela loja.
Com Preço atual do produto, as próximas cobranças consideram o valor vigente do produto.
Com Preço no momento da compra, o valor utilizado na contratação é mantido nas recorrências seguintes.
Depende da configuração da loja.
Caso o cancelamento direto esteja permitido, o cliente pode concluir a ação pela Minha Conta.
Quando a opção cancelar via solicitação estiver habilitada, a assinatura passa para Cancelamento solicitado e a loja precisa concluir o cancelamento.
Não. O cancelamento é definitivo.
Atualizado em 03/09/2026
Deixe um comentário