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.

​
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.

​
Mantendo assinaturas com vários produtos intactas

Por padrão, quando um upgrade de frequência ou de frequência-e-produto se aplica a um cliente com duas ou mais linhas ativas na sua assinatura do Loop, o Aftersell divide o produto com upgrade em uma nova assinatura. Isso mantém os outros itens na cadência de cobrança original. Se os outros produtos da assinatura forem complementos ao produto com upgrade (em vez de assinaturas independentes), você pode habilitar Don’t split multi-product subscriptions na oferta. Quando isso está ativado, o Aftersell reajusta o contrato inteiro para a nova frequência em vez de dividi-lo. O que esperar quando esta configuração está ativada:
  • Os outros produtos da assinatura também passam para a nova frequência.
  • Esses produtos mantêm o desconto do plano de venda da frequência original, mas na nova cadência.
  • O Aftersell não garante o preço correto para itens irmãos — se um produto irmão estiver em um plano de preço fixo sem plano correspondente na nova frequência, ele mantém seu preço absoluto original na nova cadência.
Habilite isso apenas quando os outros produtos forem complementos ao produto com upgrade. Se forem assinaturas independentes, use o comportamento padrão de divisão para que cada produto permaneça em sua própria agenda de cobrança.
Esta configuração está disponível para os tipos de upgrade frequência e frequência + produto apenas no Loop. Ela aparece como uma caixa de seleção no painel de configurações da oferta.

​
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 quando um upgrade de assinatura com várias linhas usa o comportamento padrão de divisão. O Loop as trata em duas etapas (dividir e depois remover), o que pode fazer com que linhas temporárias apareçam durante a janela de sincronização de 24 horas. Elas se resolvem automaticamente quando a sincronização é concluída. Se você quiser evitar a divisão por completo, veja Mantendo assinaturas com vários produtos intactas.
← Voltar para Visão geral dos upgrades de assinatura · Configuração · O que são integrações?