> ## 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 Loop

> Guia passo a passo para conectar o Loop e configurar os Upgrades de Assinatura no Aftersell, incluindo limitações específicas do Loop.

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](/pt/aftersell/subscription-upgrades).

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

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](/pt/aftersell/subscription-upgrades-add-item))
* Apenas frequências pós-pagas (pré-pago não é suportado — consulte [Limitações](#loop-specific-limitations) abaixo)

<div id="loop-specific-limitations">
  ## Limitações específicas do Loop
</div>

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

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

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](https://loop.app/docs).

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

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.

<div id="before-you-configure-the-upgrade-step-3">
  ## Antes de configurar o upgrade (Etapa 3)
</div>

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.

<Note>
  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](#loop-specific-limitations) para detalhes.
</Note>

<div id="selecting-a-recurring-discount-tier">
  ### Selecionando um nível de desconto recorrente
</div>

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.

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

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.

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

**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](/pt/aftersell/subscription-upgrades) · [Configuração](/pt/aftersell/subscription-upgrades-setup) · [O que são integrações?](/pt/aftersell/subscription-upgrades-integrations)