Skip to main content
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.

​
Recursos suportados

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)
  • Frequências pré-pagas e pós-pagas

​
Gerando seu token de API do Recharge

  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.

​
Conectando o Recharge no assistente de configuração

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.

​
Verificando um upgrade no Recharge

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.

​
Solução de problemas específicos do Recharge

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 · Configuração · O que são integrações?