> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appreval.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Gestão de assinaturas ativas, pausadas e canceladas
> Consulte, filtre e gerencie todas as assinaturas da sua loja: ativas, pausadas, canceladas e com pagamento falhado, tudo pela Reval.
A seção de Assinaturas na Reval é o centro de operações do dia a dia. A partir daqui você pode ver em tempo real o status de todos os seus assinantes, buscar uma assinatura específica, revisar o histórico de cobranças de um cliente e tomar ações manuais quando a situação exigir. Tudo fica registrado para que você tenha rastreabilidade completa do que acontece na sua loja.
## Lista de assinaturas
A lista mostra todas as assinaturas da sua loja, paginadas, como cartões. Cada um leva como título a data da **próxima cobrança** (ou o status que a substitui: "Cancelada", "Ciclos concluídos — sem mais cobranças", "Sem próxima cobrança") e mostra o produto com a sua imagem, a quantidade, a frequência, o preço, quantos pedidos ele gerou e quando foi criado. As assinaturas de [caixa](/pt/lojista/caixas) mostram o nome e a imagem da caixa, com o seu tipo e quantos produtos distintos ela inclui.
### Filtrar e buscar
* **Abas de status** com a contagem ao vivo: **Todas**, **Ativas**, **Pausadas**, **Canceladas** e **Pendentes**. Uma assinatura que alcançou o máximo de ciclos do plano continua constando como **Ativa**, com o aviso "Ciclos concluídos — sem mais cobranças".
* **Busca** por e-mail, nome, sobrenome, telefone ou ID da assinatura. Você pode combinar vários termos (por exemplo, nome + sobrenome), e ela também serve para encontrar uma assinatura a partir do código de confirmação que o cliente vê.
Além do status principal, os cartões marcam duas situações de cobrança: **Cobrança falhada** (o Mercado Pago recusou a última tentativa) e **Cobrança em processamento** (o MP ainda está analisando o pagamento).
Não há filtros por produto, plano ou intervalo de datas nesta tela. Para esses cortes, exporte as assinaturas para CSV em [Ferramentas](/pt/lojista/operacoes-em-massa), que filtra por status, produtos e datas.
## Detalhe de uma assinatura
Clique em qualquer linha da lista para abrir o detalhe completo daquela assinatura. A visão de detalhe se organiza nas seguintes seções:
### Informações gerais
Esta seção mostra os dados principais da assinatura:
* **Cliente**: nome, e-mail e link para o perfil do cliente na Shopify.
* **Plano**: nome do plano, frequência e desconto aplicado.
* **Produtos**: lista de produtos incluídos na assinatura com as suas variantes e quantidades.
* **Valor da próxima cobrança**: preço com o desconto aplicado.
* **Data da próxima cobrança**: próxima data programada pelo Mercado Pago.
* **Endereço de entrega**: endereço registrado para os pedidos gerados por esta assinatura. Você pode editá-lo diretamente por este painel clicando em **Editar endereço**.
* **Economia acumulada**: total economizado pelo cliente desde que iniciou a assinatura, calculado como a soma dos descontos aplicados em cada ciclo cobrado.
### Histórico de cobranças
A tabela de histórico mostra cada tentativa de cobrança realizada pelo Mercado Pago para esta assinatura:
| Coluna | Descrição |
| ------ | -------------------------------------------------------------------- |
| Data | Data e hora da tentativa de cobrança |
| Valor | Valor cobrado ou tentado |
| Status | **Cobrado**, **Falhado** ou **Pendente** |
| Pedido | Link para o pedido gerado na Shopify (só em cobranças bem-sucedidas) |
### Ações disponíveis
Pelo detalhe da assinatura você pode executar as seguintes ações manuais:
Pausar interrompe o ciclo de cobranças de forma temporária. O cliente não é cobrado enquanto a assinatura está pausada e não recebe novos pedidos. Clique em **Pausar**, informe um motivo interno (opcional, visível apenas para a equipe da sua loja) e confirme. A assinatura passa ao status **Pausada**.
Disponível somente quando a assinatura está no status **Pausada**. Ao retomar, a Reval reprograma a próxima cobrança a partir da data atual conforme a frequência do plano. Clique em **Retomar** e confirme a ação.
O cancelamento é permanente. Clique em **Cancelar**, selecione o motivo do cancelamento na lista (ou informe um personalizado) e confirme. A assinatura passa ao status **Cancelada** e o mandato não pode ser revivido. Quando o cancelamento foi **por cobranças falhadas**, o cliente vê no portal dele o botão **Reativar assinatura**, que cria uma assinatura nova (mesmos produtos e endereço, cartão novo, preço de tabela atual) vinculada à anterior no histórico. Para qualquer outro cancelamento, o cliente teria que iniciar uma nova assinatura pela loja.
Na seção **Produtos da assinatura** você pode mudar quantidades, remover linhas (sempre resta pelo menos uma) e **adicionar outro produto** — o seletor oferece os produtos com um plano ativo na **mesma frequência**, porque todos os produtos de uma assinatura compartilham o mandato. Ao clicar em **Salvar produtos**, a Reval recalcula o preço (plano × quantidade), atualiza o valor no Mercado Pago com efeito a partir do próximo ciclo, refaz a cotação do frete para a nova composição e deixa a mudança registrada no histórico.
Se a assinatura é uma [caixa](/pt/lojista/caixas), em vez do editor de produtos você verá **Composição da caixa**: você muda o tamanho e as quantidades, remove e adiciona produtos elegíveis, com o detalhamento de preço ao vivo e as mesmas validações de tamanho que o cliente vê. **Salvar caixa** recalcula o total (vale a partir do próximo ciclo). Abaixo, **Produtos adicionais (fora da caixa)** gerencia os recorrentes que acompanham cada entrega sem contar para o tamanho nem para os descontos.
Mesmo que o cliente esteja dentro da **janela de faturamento** (o portal dele bloqueia a edição 24 horas antes da cobrança), você pode salvar de todo modo: a mudança vale a partir do próximo ciclo, nunca sobre uma cobrança já em processo.
A seção **Ajuste de preço** permite duas coisas, para casos pontuais (uma compensação, um acordo especial):
* **Preço personalizado total**: substitui o total calculado pelos produtos.
* **Desconto (%)**: aplica um percentual sobre o total de produtos. É ignorado se houver preço personalizado.
O ajuste vale a partir do **próximo ciclo**. Atenção: se depois você editar os produtos da assinatura, o preço é recalculado e **o ajuste é substituído**.
Se o cliente comprou [add-ons](/pt/assinante/add-ons), eles aparecem em uma seção própria com o seu status: **Pendente de envio** (viaja com a próxima entrega), **Enviada** (com a data e o link para o pedido) ou **Removida**. Uma compra pendente pode ser removida com o botão **Quitar** (o admin é exibido em espanhol) para que não seja enviada — mas isso não estorna a cobrança, que já foi processada: o estorno é feito pelo painel do Mercado Pago.
O botão **Copiar Portal Link** gera um link assinado e com vencimento que abre o portal **com a mesma visão e o mesmo acesso que aquele cliente tem**. É a ferramenta de suporte: se o cliente não encontra algo ou precisa que você o guie, você abre o portal dele e vê exatamente o que ele vê. O link vence sozinho, então não fica um acesso permanente à solta.
Todas as ações manuais que você executa sobre uma assinatura — pausar, retomar e cancelar — ficam registradas no **log de auditoria** com o timestamp exato e o usuário da Shopify que realizou a ação. Esse registro não pode ser modificado nem excluído, e é visível pelo histórico da assinatura.
## Assinaturas com pagamentos falhados
Quando o Mercado Pago não consegue processar uma cobrança (saldo insuficiente, cartão vencido, limite excedido, etc.), a assinatura passa automaticamente ao status **Pagamento falhado**. Isso não cancela a assinatura — significa que a cobrança do ciclo atual não pôde ser concluída.
### Quem tenta a cobrança de novo
**Quem tenta de novo é o Mercado Pago, não a Reval.** O MP volta a tentar a cobrança por conta própria nos dias seguintes, com o critério e a cadência dele — não publicamos isso porque não controlamos nem podemos garantir.
A Reval não tem um job de novas tentativas de cobrança e **não há forma de forçar uma nova tentativa**, nem pelo admin nem pelo portal. O que a Reval faz é registrar a recusa com o motivo e exibi-la no detalhe da assinatura e no portal do cliente.
Se as tentativas do Mercado Pago se esgotarem, **o MP cancela o mandato** e a assinatura passa a **Cancelada**, com o motivo registrado na timeline. Nenhum pedido é gerado por um ciclo que não foi cobrado.
Cada tentativa de cobrança — bem-sucedida ou falhada — fica registrada no histórico de cobranças da assinatura com a sua data, valor e status. Assim você tem visibilidade completa do ciclo de vida de cada pagamento.
### Como gerenciar os pagamentos falhados
Na lista, as assinaturas afetadas aparecem marcadas com a etiqueta **Cobrança falhada**. Pelo detalhe de cada uma você pode:
* Revisar a timeline da assinatura, onde a recusa fica registrada com o seu motivo.
* Entrar em contato com o cliente para avisar que a cobrança dele foi recusada.
* Cancelar a assinatura manualmente se não fizer mais sentido mantê-la ativa.
**Só o cliente pode trocar o cartão, pelo portal dele.** Os tokens do Mercado Pago são emitidos com o titular presente, então você não pode cadastrar um cartão novo em nome dele pelo admin. Se a cobrança falhou porque o cartão não serve mais, avisar em tempo é a única alavanca que você tem.
Se você montar uma comunicação proativa para esses casos —com Klaviyo ou Shopify Flow, veja [Configuração](/pt/lojista/configuracao)— o que é acionável para o cliente é: verificar saldo ou limite disponível, ou **trocar o meio de pagamento pelo portal dele** (o aviso de cobrança recusada inclui o acesso direto) se o cartão não serve mais.