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

# Módulo de upgrades de assinatura

> Permita que os clientes alternem entre compras únicas e assinaturas diretamente do carrinho usando o módulo Subscription Upgrades.

<div id="overview">
  # Visão geral
</div>

Este guia mostra como habilitar e configurar essas opções no Upcart e inclui dicas para personalizar o texto dos botões, os rótulos de exibição e a formatação dos planos de assinatura. Quando habilitado, o módulo adiciona duas opções interativas aos itens do carrinho qualificados:

* **Upgrade para uma assinatura**
* **Downgrade para uma compra única (OTP)**

Essas opções aparecem como menus suspensos ou botões ao lado de cada produto elegível, permitindo que os clientes alterem facilmente o tipo de compra antes de finalizar o pedido.

<div id="upgrade-to-a-subscription">
  # **Upgrade para uma assinatura**
</div>

Quando um produto oferece planos de assinatura, os clientes verão no carrinho um convite para fazer upgrade da compra. Se o seu produto tiver vários intervalos de assinatura, o cliente poderá escolher entre eles. Ele também pode voltar para uma compra única, se você permitir.

<div id="button-text">
  ## Texto do botão
</div>

Por padrão, o botão de upgrade exibe o **Selling Plan Group Name**, que é obtido diretamente do seu app de assinaturas. Você pode substituí-lo editando o rótulo do botão e removendo a variável `{{selling_plan_group_name}}`, se necessário.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/subscription-upgrades-button-text-field.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=acc0621627241ed3adcf110b05d07566" alt="Campo Button text do Upcart definido como Upgrade to Subscription ao lado de uma pré-visualização do botão de upgrade no carrinho" width="1860" height="468" data-path="images/upcart/subscription-upgrades-button-text-field.png" />

<div id="override-subscription-plan-options-text">
  ## Substituir o texto das opções de plano de assinatura
</div>

Esta configuração controla como os intervalos de assinatura são exibidos no menu suspenso. O texto inclui a variável `{{selling_plan_name}}`, que reflete a frequência da assinatura (por exemplo, "Entregue todo mês"). Para editar esse texto, marque **Override subscription plan options text**. Isso desbloqueia um campo em que você pode inserir seu rótulo personalizado.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/subscription-upgrades-override-settings-plan-options.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=91ea90da591d41e2b1ec6a45d8833577" alt="Configurações de substituição do Upcart para o texto das opções de plano de assinatura usando variáveis de nome do plano de venda" width="1008" height="687" data-path="images/upcart/subscription-upgrades-override-settings-plan-options.png" />

<div id="subscription-plan-options-one-time-purchase-text">
  ## Texto de compra única nas opções de plano de assinatura
</div>

Este é o rótulo exibido quando um cliente opta por não assinar. O padrão é "One-time purchase". Para personalizar esse rótulo, marque **Override subscription plan options text** e use o campo **Subscription plan options one-time purchase text** logo abaixo.

A mesma caixa de seleção desbloqueia mais dois campos:

* **Subscription plan full price text** — o título do grupo no menu suspenso acima da opção de compra única. O padrão é "Full price".
* **Subscription plans heading text** — o título acima das opções de plano de assinatura.

Tanto o **Selling Plan Group Name** quanto o **Selling Plan Name** são gerados pelo seu app de assinaturas, não pelo Upcart. Se você precisar localizar ou traduzir esses nomes, consulte as configurações do seu app de assinaturas.

**Nota:** O Upcart se integra à **[Subscription API do Shopify](https://shopify.dev/docs/api/admin-graphql/2023-10/objects/sellingplan#top)**, o que significa que ele oferecerá suporte a todos os aplicativos de assinatura modernos.

<div id="downgrade-to-a-one-time-purchase">
  # **Downgrade para uma compra única**
</div>

Se um produto oferece tanto assinaturas quanto compras únicas, os clientes também verão a opção de voltar atrás. Ela é apresentada no mesmo menu suspenso usado para selecionar os planos de assinatura.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/subscription-upgrades-cart-item-plan-dropdown.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=c24d248f4fed0d6fadf6739f8a8904a7" alt="Item do carrinho do Upcart com um menu suspenso para alternar entre assinar e economizar e compra única" width="889" height="415" data-path="images/upcart/subscription-upgrades-cart-item-plan-dropdown.png" />

Para impedir que os clientes voltem para uma compra única, habilite a configuração **Prevent Downgrades** na parte inferior da configuração do Subscription Upgrades. Quando marcada, a opção "One-time purchase" é removida completamente do menu suspenso.

Impedir downgrades pode ajudar a aumentar as conversões de assinatura, mas também pode criar atrito. Se os clientes não tiverem a flexibilidade de alternar, eles podem remover o produto por completo ou abandonar o carrinho. Considere testar esta configuração antes de habilitá-la definitivamente.
