> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upgrades de assinatura com Recharge

> Guia passo a passo para conectar o Recharge e configurar os Upgrades de Assinatura no Aftersell.

Esta página cobre tudo o que é específico do uso do **Recharge** com os Upgrades de Assinatura. Para uma visão geral completa de como os Upgrades de Assinatura funcionam, consulte [Upgrades de Assinatura](/pt/aftersell/subscription-upgrades).

<div id="supported-features">
  ## Recursos suportados
</div>

O Recharge suporta todos os tipos de Upgrade de Assinatura:

* Alterar a frequência de entrega ou de cobrança
* Substituir por um produto diferente
* Ambos – alterar a frequência e substituir o produto
* Adicionar outro item assinável à assinatura (consulte [Adicionar um item](/pt/aftersell/subscription-upgrades-add-item))
* Frequências pré-pagas e pós-pagas

<div id="generating-your-recharge-api-token">
  ## Gerando seu token de API do Recharge
</div>

1. Faça login no seu portal de lojista do Recharge.
2. Navegue até **Tools & Apps → API Tokens**.
3. Clique em **Create an API Token**.
4. Insira um nome e um e-mail de contato.
5. Defina as permissões de que o Aftersell precisa: **Read and Write** em Subscriptions e **Read** em Orders e Plans. Nenhum escopo de Products é necessário.
6. Clique em **Save** e copie a chave de API.

O token deve conter todos os quatro escopos: `read_orders`, `read_subscriptions`, `write_subscriptions` e `read_plans`. O Aftersell verifica os quatro quando você testa a chave e indica na mensagem de erro os que estiverem faltando.

Para mais detalhes, consulte a [documentação da API do Recharge](https://docs.rechargepayments.com/).

<div id="connecting-recharge-in-the-setup-wizard">
  ## Conectando o Recharge no assistente de configuração
</div>

Quando você chegar à **Etapa 1: Connect provider** no assistente de Upgrade de Assinatura:

1. Selecione **Recharge** no dropdown **Subscription provider**.
2. Cole seu token de API no campo **API token**.
3. Clique em **Test API key**. O Aftersell valida o token, verificando se ele autentica corretamente, possui todos os escopos necessários e pertence à sua loja.
4. Quando o teste passar (marca verde), clique em **Continue** para avançar para a Etapa 2.

O resultado do teste mostra um de dois estados:

* **Marca verde — "API key verified".** O token foi autenticado, todos os escopos necessários estão presentes e o token pertence à sua loja. **Continue** agora está habilitado.
* **Ícone vermelho de cancelamento.** A verificação não foi concluída com sucesso. Leia a mensagem ao lado do ícone: ou o token foi rejeitado ou está sem os escopos necessários. A mensagem indica os escopos específicos que faltam. Corrija o token no Recharge e teste novamente. Ou o Aftersell não conseguiu concluir a verificação ("Could not verify the API key. Please try again."), o que é uma chamada que falhou e não um token inválido — nesse caso, basta testar novamente.

Um resultado de não-verificação se parece exatamente com uma rejeição, então guie-se pela mensagem e não pelo ícone. **Continue** permanece desabilitado até a verificação voltar verde, e editar o provedor ou o token limpa o resultado anterior.

<div id="verifying-an-upgrade-in-recharge">
  ## Verificando um upgrade no Recharge
</div>

Depois de fazer um pedido de teste e aceitar a oferta de upgrade:

Vá para **Customers** no seu painel do Recharge, localize o cliente e abra **Subscriptions**. A assinatura ativa deve refletir imediatamente a nova frequência, o novo produto ou o novo desconto.

O Recharge é atualizado quase em tempo real após a aceitação.

<div id="troubleshooting-recharge-specific-issues">
  ## Solução de problemas específicos do Recharge
</div>

**O upgrade foi aceito, mas a assinatura não foi modificada**

As causas mais comuns:

* Seu token de API está expirado ou não possui as permissões necessárias. O token deve ter `read_orders`, `read_subscriptions`, `write_subscriptions` e `read_plans`. Vá para a **Etapa 1: Connect provider**, teste novamente sua chave e verifique a mensagem de erro para identificar os escopos que faltam.
* O produto elegível no funil não corresponde ao que o cliente realmente assinou.

O Aftersell tenta novamente de forma automática as chamadas ao provedor que falharam em um fluxo de trabalho em segundo plano. Se todas as tentativas falharem, entre em contato com o suporte informando a URL da sua loja, o ID do pedido na Shopify, o e-mail do cliente, o horário aproximado em que o upgrade foi aceito e o provedor que você está usando.

**O dropdown de planos de venda está vazio**

A opção "Use an existing selling plan" busca os planos diretamente do Recharge. Se o dropdown estiver vazio:

* Confirme se os planos de venda estão configurados no seu painel do Recharge.
* Verifique se o seu token de API tem o escopo `read_plans`.
* Volte à **Etapa 1: Connect provider**, teste novamente sua chave de API e continue.

***

← Voltar para [Visão geral dos upgrades de assinatura](/pt/aftersell/subscription-upgrades) · [Configuração](/pt/aftersell/subscription-upgrades-setup) · [O que são integrações?](/pt/aftersell/subscription-upgrades-integrations)