Skip to main content
Esta página cobre tudo o que é específico do uso do Loop com os Upgrades de Assinatura, incluindo suas limitações exclusivas. Para uma visão geral completa de como os Upgrades de Assinatura funcionam, consulte Upgrades de Assinatura.

​
Recursos suportados

O Loop 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)
  • Apenas frequências pós-pagas (pré-pago não é suportado — consulte Limitações abaixo)

​
Limitações específicas do Loop

  • A frequência de cobrança deve ser igual à frequência de entrega. O Loop não suporta assinaturas pré-pagas por meio desta integração. O campo de frequência de cobrança fica desabilitado e é sincronizado automaticamente com a frequência de entrega. Essa é a maior restrição a ter em mente se a sua loja depende de planos pré-pagos.
  • Assinaturas com várias linhas são tratadas em duas etapas: a linha do produto alvo é dividida em uma nova assinatura com a frequência desejada e, em seguida, removida da original. Isso envolve múltiplas chamadas de API e pode exibir linhas temporárias em andamento no seu painel do Loop durante a janela de sincronização.
  • Frequência personalizada não é suportada para assinaturas com várias linhas. Quando você define a frequência manualmente (sem selecionar um plano de venda), o upgrade funciona para clientes cuja assinatura contém uma única linha de produto. Clientes com uma assinatura de múltiplos produtos ou bundle (duas ou mais linhas ativas) terão o upgrade falhando se não existir um plano de venda correspondente para a frequência alvo. Para atender esses clientes, crie o plano de venda correspondente no seu painel do Loop.

​
Gerando seu token de API do Loop

  1. Abra o app Loop e navegue até Settings no canto inferior esquerdo.
  2. Em Admin, clique em API Tokens.
  3. Defina as permissões de que o Aftersell precisa: Read and Write em Subscription contracts e Read em Orders e Selling plans. O acesso de escrita é necessário apenas para assinaturas.
  4. Clique em Generate New Token.
  5. Informe um nome, selecione os escopos apropriados e clique em Generate Token.
  6. Clique em Show Token para visualizar e copiar sua chave. Trate-a como uma senha e guarde-a em um lugar seguro.
Para mais detalhes, consulte a documentação da API do Loop.

​
Conectando o Loop no assistente de configuração

Quando você chegar à Etapa 1: Connect provider no assistente de Upgrade de Assinatura:
  1. Selecione Loop 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 Loop 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.

​
Antes de configurar o upgrade (Etapa 3)

Ao configurar uma mudança de frequência, você pode escolher um plano de venda existente ou definir a frequência manualmente:
  • Usar um plano de venda existente. Escolha no dropdown de planos de venda. O plano já deve existir e estar ativo no seu painel do Loop.
  • Definir a frequência manualmente. Insira você mesmo a frequência de entrega. O Loop aceita qualquer cadência sem exigir um plano de venda correspondente. Você também pode aplicar um desconto recorrente ao usar uma frequência manual.
Se você definir a frequência manualmente e a assinatura do cliente tiver duas ou mais linhas de produto ativas (um contrato de múltiplos produtos ou bundle), o upgrade falhará a menos que exista um plano de venda correspondente para a frequência alvo. Consulte Limitações para detalhes.

​
Selecionando um nível de desconto recorrente

Alguns planos de venda do Loop aplicam descontos diferentes em momentos diferentes da assinatura — por exemplo, $20 de desconto na primeira cobrança e $10 de desconto da segunda cobrança em diante. Quando você seleciona um plano assim, o campo Recurring discount é substituído por uma lista de botões de opção mostrando cada um dos níveis de desconto do plano com seu intervalo de cobrança (por exemplo, “Charge 1” ou “Charge 2 onward”). Selecione o nível que você deseja aplicar a todas as renovações futuras da assinatura com upgrade. O nível selecionado é salvo com a oferta e aplicado quando um cliente aceita o upgrade. Se o plano selecionado não tiver níveis de desconto, ou se você estiver definindo a frequência manualmente, o campo padrão de desconto de entrada livre aparece no lugar.

​
Verificando um upgrade no Loop

Depois de fazer um pedido de teste e aceitar a oferta de upgrade: Vá para Subscriptions no seu painel do Loop e localize a assinatura do cliente. As chamadas de upgrade do Loop são síncronas, então não há atraso de processamento do lado do Aftersell — a alteração é aplicada no Loop no momento em que a chamada retorna. A própria lista de assinaturas do Loop pode demorar um pouco mais para se atualizar, então, se ainda não estiver lá, aguarde alguns minutos e atualize a página antes de tratar como uma falha. Se a alteração não estiver lá, ela não foi aplicada — veja abaixo.

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

Não consigo alterar a frequência de cobrança Isso é esperado. O Loop não suporta assinaturas pré-pagas por meio desta integração. O campo de frequência de cobrança fica desabilitado e é sincronizado automaticamente com a frequência de entrega. O upgrade foi aceito, mas a assinatura não foi modificada Se a assinatura permanece inalterada, as causas mais comuns são:
  • Você definiu a frequência manualmente e a assinatura do cliente tem duas ou mais linhas de produto ativas. Nesse caso, o Loop exige um plano de venda correspondente para a frequência alvo. Crie o plano de venda no Loop ou mude para Use an existing selling plan na configuração da oferta.
  • Você usou Use an existing selling plan e o plano de venda selecionado não existe mais no seu painel do Loop. Crie o plano de venda no Loop e tente novamente.
  • Seu token de API está expirado ou não possui as permissões necessárias: write em Subscription contracts, read em Orders e Selling 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 Loop. Se o dropdown estiver vazio:
  • Confirme se os planos de venda estão configurados no seu painel do Loop.
  • Verifique se o seu token de API tem acesso de Read a Selling plans.
  • Volte à Etapa 1: Connect provider, teste novamente sua chave de API e continue.
Linhas temporárias em andamento aparecem no meu painel do Loop Isso é esperado para assinaturas com várias linhas. O Loop as trata em duas etapas (dividir e depois remover), então uma linha temporária pode aparecer entre as duas. Ela é resolvida assim que a segunda etapa é concluída.
← Voltar para Visão geral dos upgrades de assinatura · Configuração · O que são integrações?