> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://supr-bundles-and-subscriptions.crisp.help/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Usar o Supr Bundles & Subscriptions com outros apps e ferramentas Quer saber se o Supr Bundles & Subscriptions funciona com seu tema, seu construtor de páginas ou outro app que você já usa? Resposta curta: o app é construído sobre o **sistema de assinaturas da própria Shopify**, e cada cobrança de renovação cria um **pedido normal da Shopify**, então a maioria dos apps que funcionam com pedidos e clientes da Shopify (ferramentas de e-mail, apps de fidelidade, apps de processamento de pedidos, Shopify Flow) funciona também com suas assinaturas. O que **não** se combina é outro widget de kit ou de assinatura no mesmo produto, e tudo o que fica fora do tema da sua loja virtual, como uma loja headless ou o Shopify POS. Este guia passa por cada tipo de app e ferramenta sobre os quais os lojistas perguntam, o que funciona, o que não funciona e o que fazer no lugar. ### Índice * [Respostas rápidas](#3-respostas-rapidas) * [Como o app convive com outros apps](#3-como-o-app-convive-com-outros-apps) * [Outros apps de kits, como o Kaching Bundles](#3-outros-apps-de-kits-como-o-kaching-bundles) * [Manter outro app de assinaturas instalado](#3-manter-outro-app-de-assinaturas-instalado) * [Apps de upsell](#3-apps-de-upsell) * [Apps de seletor de variantes, amostras e opções de produto](#3-apps-de-seletor-de-variantes-amostras-e-opcoes-de-produto) * [Produtos do app Shopify Bundles em assinatura](#3-produtos-do-app-shopify-bundles-em-assinatura) * [Apps de fidelidade e pontos, como Smile e LoyaltyLion](#3-apps-de-fidelidade-e-pontos-como-smile-e-loyaltylion) * [Ferramentas de e-mail, como Klaviyo, Omnisend e Shopify Email](#3-ferramentas-de-e-mail-como-klaviyo-omnisend-e-shopify-email) * [Shopify Flow](#3-shopify-flow) * [Apps de processamento de pedidos e 3PLs](#3-apps-de-processamento-de-pedidos-e-3pls) * [Shopify POS](#3-shopify-pos) * [Headless, Hydrogen e tokens da Storefront API](#3-headless-hydrogen-e-tokens-da-storefront-api) * [Construtores de páginas, como PageFly e GemPages](#3-construtores-de-paginas-como-pagefly-e-gempages) * [Apps de teste A/B e de teste de preços](#3-apps-de-teste-ab-e-de-teste-de-precos) * [Temas](#3-temas) * [Perguntas frequentes](#3-perguntas-frequentes) * [Guias relacionados](#3-guias-relacionados) ### Respostas rápidas | App ou ferramenta | Funciona com o Supr Bundles & Subscriptions? | |---|---| | Outros apps de kits (Kaching Bundles e similares) | Não junto com nossas assinaturas. Use nossas opções de kit. | | Outro app de assinaturas | Pode continuar instalado durante a migração, mas nunca no mesmo produto. | | Apps de seletor de variantes e amostras | Sim, quando usam as variantes reais da Shopify. | | Apps de opções de produto | As opções que não são variantes reais da Shopify não fazem parte da assinatura. | | Produtos do app Shopify Bundles | Sim, em assinatura, com algumas regras. | | Apps de fidelidade e pontos (Smile, LoyaltyLion) | Sem integração direta. Os pontos nos pedidos de renovação geralmente funcionam. | | Klaviyo | Sim. Enviamos os eventos das suas assinaturas ao Klaviyo. Conecte em Configurações > Integrações > Klaviyo. | | Outras ferramentas de e-mail (Omnisend, Shopify Email) | Sem integração direta. Use os pedidos e nossas tags de cliente. | | Shopify Flow | Sim, com os acionadores de assinatura da própria Shopify. | | Apps de processamento de pedidos e 3PLs | Sim. Cada renovação é um pedido normal da Shopify. | | Shopify POS | Sem integração com o POS. Pergunte a nós antes de contar com isso. | | Headless e Hydrogen | Sem widget. Um desenvolvedor pode vender assinaturas pela Storefront API da Shopify. | | Construtores de páginas (PageFly, GemPages, Shogun) | Sim nas páginas de produto. As landing pages precisam do bloco de app. | | Teste A/B | Integrado: teste de duas a quatro versões de uma oferta em Crescimento > Testes A/B. | | Temas | Sim, pela incorporação de app. | ### Como o app convive com outros apps O Supr Bundles & Subscriptions não tem checkout nem sistema de pagamento próprio. Ele usa os componentes de assinatura que a Shopify oferece: * Os compradores finalizam a compra pelo carrinho e pelo checkout normais da Shopify. * Cada assinatura é um contrato de assinatura da Shopify, que você gerencia em [**Supr Bundles & Subscriptions > Assinaturas**](https://admin.shopify.com/apps/super-subscriptions/app/contracts). * Cada renovação bem-sucedida cria um **novo pedido da Shopify**, que aparece nos seus pedidos, nos relatórios e em todos os apps conectados aos seus pedidos. * Os preços dos kits são aplicados no checkout por descontos nossos na Shopify, chamados **Supr Bundle Pricing** e **Supr Bundle Block Pricing** (instalações mais antigas ainda podem mostrá-los com o nome antigo do app até o app os atualizar). A regra prática é: **um app que lê pedidos e clientes da Shopify já enxerga seus pedidos de assinatura e seus assinantes.** Os problemas vêm de apps que alteram a página do produto ou o carrinho no mesmo lugar que nós: outro widget de kit, outro widget de assinatura, ou um app que substitui o botão de adicionar ao carrinho. ### Outros apps de kits, como o Kaching Bundles **Nossas assinaturas não se combinam com os kits de outro app.** A Shopify só permite que um kit e uma assinatura funcionem juntos quando ambos são feitos para isso, e não nos integramos com outros apps de kits (Kaching Bundles e similares). É por isso que, aqui, kits e assinaturas ficam no mesmo app. Rodar outro app de kits no mesmo produto costuma causar um destes problemas: * Dois widgets na mesma página, o que confunde os compradores. * O outro app substitui o botão de adicionar ao carrinho, e a assinatura que o comprador escolheu nunca chega ao carrinho. * O desconto automático do outro app compete com o nosso. A Shopify nunca soma dois descontos de produto em uma linha do carrinho: ela cobra o maior e ignora o outro, então os preços dos seus kits mudam no carrinho. Veja [Quando outro app de descontos sobrepõe seus preços](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/how-subscription-discounts-work-1btg9f3/#3-quando-outro-app-de-descontos-sobrepoe-seus-precos). **O que fazer no lugar:** monte o kit como **opções de kit** em uma oferta. Escolha o tipo de oferta **Kit + Assinatura** e os clientes poderão comprar cada kit uma única vez ou em assinatura. Descontos por quantidade, Compre X, leve Y, kits fixos e monte seu próprio kit estão todos disponíveis, veja [Tipos de kit](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/bundle-types-quantity-breaks-buy-x-get-y-fixed-bundles-and-build-a-box-q04e6x/). Depois, nos produtos das suas ofertas, desligue a incorporação de app do outro app e remova os blocos dele no editor de temas, ou desinstale-o se não precisar mais dele. Em **Admin da Shopify > Descontos**, pause os descontos automáticos que ele deixou e que abrangem os mesmos produtos. || Não podemos mudar como os itens de outro app de kits aparecem no portal do cliente, nas páginas de pedido ou nos e-mails. Esses itens são de responsabilidade do app deles. ### Manter outro app de assinaturas instalado Você pode manter seu app de assinaturas antigo (Recharge, Seal, Appstle, Shopify Subscriptions e assim por diante) instalado durante a migração. Cada app renova apenas as próprias assinaturas, e nosso widget só mostra as nossas ofertas, então ninguém é cobrado duas vezes pela mesma assinatura. Tenha estas regras em mente: * **Nunca venda o mesmo produto pelos dois apps.** Nos produtos que estão em uma das nossas ofertas, desligue a incorporação de app do outro app e remova os blocos de widget dele, para que os compradores vejam um só widget. * **Não desinstale o app antigo enquanto ele ainda tiver assinantes que você quer manter.** Desinstalá-lo encerra a cobrança dele. Migre-os antes, na ordem descrita em [Migrar para o Supr Bundles & Subscriptions](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/migrating-to-super-subscriptions-18c7rbb/). * **Limpe os descontos dele.** Apps antigos de assinatura e de kits costumam deixar descontos automáticos para trás. Pause os que você não usa mais em **Admin da Shopify > Descontos**. Se você ainda não tem assinantes no app antigo, pode simplesmente desinstalá-lo. ### Apps de upsell O app tem upsells e vendas cruzadas próprios em [**Supr Bundles & Subscriptions > Crescimento**](https://admin.shopify.com/apps/super-subscriptions/app/grow), veja [Upsells](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/upsells-w393d/). Você não precisa remover outro app de upsell, mas um que substitui o botão de adicionar ao carrinho ou adiciona descontos automáticos próprios pode entrar em conflito das mesmas formas que um app de kits. Se as assinaturas começarem a ir ao carrinho como compras únicas, desligue-o por um momento e teste de novo. ### Apps de seletor de variantes, amostras e opções de produto As assinaturas se vinculam a **variantes reais de produto da Shopify**, as que você cria em **Variantes** de um produto no admin da Shopify. Essa é uma regra da Shopify para todos os apps de assinatura, não algo específico do nosso. * **Apps de seletor de variantes e de amostras** que apenas mudam a aparência das suas variantes reais (amostras de cor, botões, imagens) podem ser usados com o widget. Se os preços ou as opções do widget não mudam quando um comprador escolhe outra variante, veja [Trocar a variante do produto não atualiza o widget](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/changing-a-product-variant-is-not-updating-the-widget-pricesoptions-19y67vc/) e envie o link do produto. * **Apps de opções de produto** que adicionam escolhas que não são variantes reais (texto de gravação, opções extras, "infinite options") não fazem parte da assinatura. Elas não podem ser assinadas, trocadas nem receber desconto do app. Se um app de opções cobra por uma opção adicionando um item de taxa separado ao carrinho, esse item é uma compra única e não entra nas renovações. Se você precisa que uma escolha seja renovada junto com a assinatura, faça dela uma variante real da Shopify. ### Produtos do app Shopify Bundles em assinatura Um produto de kit criado com o **Shopify Bundles** (o app de kits da própria Shopify) **pode** ser vendido em assinatura, com algumas regras que vêm da Shopify. **O que acontece:** a Shopify não permite adicionar um produto de kit ao carrinho com uma assinatura (a adição falha com um erro como "The bundle product ... cannot be added to the cart"). Então, quando um comprador escolhe uma assinatura em um produto de kit, o app adiciona os **produtos componentes** do kit no lugar, todos na mesma assinatura e cada um identificado com o nome do kit. O comprador finaliza uma assinatura com todos os componentes, e o app calcula o preço das linhas dos componentes para que, juntas, custem o preço do kit com o seu desconto de assinatura. As compras únicas do kit funcionam normalmente. **O que você precisa para funcionar:** 1. **Todos os produtos componentes na mesma oferta do kit.** O editor da oferta os adiciona para você e os marca como **Componente do kit**. Se algum estiver faltando, um aviso com um botão **Adicionar produtos componentes** aparece acima da lista de produtos. Veja [Produtos de kit da Shopify](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/applying-subscriptions-to-specific-products-and-collections-s40ge4/#3-produtos-de-kit-da-shopify). 2. **A oferta está Publicada**, não em Rascunho. 3. **O widget está ligado** em [**Supr Bundles & Subscriptions > Design**](https://admin.shopify.com/apps/super-subscriptions/app/widget) com **Ativar widget**. 4. **Todos os componentes estão em estoque.** Se um componente estiver esgotado, a Shopify não consegue adicionar o kit. **O que esperar:** * O carrinho e o checkout listam os componentes como linhas separadas em vez de uma única linha de kit. * Enquanto uma assinatura está selecionada em um produto de kit, os botões **Comprar agora**, **Shop Pay** e outros botões de checkout expresso ficam ocultos, porque finalizariam a compra do kit sem os componentes. Os compradores usam **Adicionar ao carrinho**. Os botões voltam para uma compra única. * O preço do kit é o preço definido no produto de kit na Shopify. Ele não acompanha mudanças posteriores nos preços dos componentes, então atualize-o você mesmo. * Alterar depois os componentes do kit na Shopify não muda as assinaturas que já existem. * Para mostrar uma opção de assinatura apenas em produtos de kit, abra essa opção e clique em **Somente produtos de kit** (um dos pequenos chips abaixo dos campos principais da opção) e depois ative-a. **Alternativa mais simples:** use opções de kit em uma oferta em uma página de produto comum. Para um multipack de um produto (2, 3 ou 4 do mesmo item), uma opção de **Desconto por quantidade** em uma oferta **Kit + Assinatura** é a escolha mais simples: uma opção "Compre 4" vende 4 unidades desse produto do próprio estoque. Para um conjunto de produtos diferentes, use um kit fixo e, para deixar o cliente escolher, use monte seu próprio kit. Veja [Tipos de kit](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/bundle-types-quantity-breaks-buy-x-get-y-fixed-bundles-and-build-a-box-q04e6x/). || Confirmamos isso com kits criados pelo Shopify Bundles. Um kit de outro app de kits só pode funcionar assim se esse app criar um produto de kit real da Shopify. A maioria dos apps de kits usa o próprio widget e os próprios descontos, e esses kits não podem ser vendidos nas nossas assinaturas. ### Apps de fidelidade e pontos, como Smile e LoyaltyLion **Não há integração direta** com Smile, LoyaltyLion ou outros apps de pontos, e o app não tem um sistema de pontos próprio. * **Ganhar pontos:** os pedidos de renovação são pedidos normais e pagos da Shopify, então um app de pontos que concede pontos por pedidos geralmente os concede também nas renovações. Cada app tem as próprias regras, então confira primeiro com uma assinatura de teste, veja [Criar um pedido de assinatura de teste](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/creating-a-test-subscription-order-2q9xp7/). * **Gastar pontos:** os apps de pontos geralmente entregam um código de desconto da Shopify. Um código só funciona em uma compra de assinatura se o **Tipo de compra** dele em **Admin da Shopify > Descontos** incluir **Assinatura**. As renovações são cobradas automaticamente, sem um checkout, então não há um momento na renovação em que um código possa ser digitado. Os assinantes podem adicionar um código à assinatura pelo portal do cliente, e a Shopify só o aceita se o código se aplicar a assinaturas. **Alternativa integrada:** um programa de fidelidade, criado em [**Crescimento > Jornadas**](https://admin.shopify.com/apps/super-subscriptions/app/grow/journeys) a partir do modelo **Recompensas de fidelidade** ou **Recompensas por gasto**, recompensa os assinantes automaticamente depois de um número de renovações ou quando gastam um valor definido, com um desconto maior, um produto grátis ou com desconto, ou um vale-presente. Veja [Programas de fidelidade](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/loyalty-programs-xgnl2l/). Se a equipe de um app de fidelidade quiser criar uma integração mais profunda, ela pode falar com o nosso suporte informando o que precisa. ### Ferramentas de e-mail, como Klaviyo, Omnisend e Shopify Email **O Klaviyo é conectado diretamente:** enviamos os eventos das suas assinaturas para a sua conta do Klaviyo e você cria os e-mails como fluxos do Klaviyo, veja [Enviar eventos de assinatura ao Klaviyo](#6-enviar-eventos-de-assinatura-ao-klaviyo) abaixo. O app **não tem conexão integrada** com Omnisend, Mailchimp ou outras plataformas de e-mail no momento. Em geral você não precisa de uma: * Os assinantes são clientes normais da Shopify e as renovações são pedidos normais da Shopify, então uma ferramenta de e-mail conectada à sua loja Shopify os captura como qualquer outro cliente e pedido. * Para distinguir os assinantes, use nossas **tags**. **Segmentar assinantes com tags:** 1. Vá em [**Supr Bundles & Subscriptions > Configurações > Tags**](https://admin.shopify.com/apps/super-subscriptions/app/settings/tags). 2. Marque as tags desejadas e clique em **Salvar** e depois em **Atualizar tags**. * Tags de cliente: **Tem contrato de assinatura**, **Tem assinatura ativa**, **Tem assinatura pausada**, **Tem assinatura cancelada**, **Tem assinatura concluída**, **Tem assinatura com falha**. * Tags de pedido: **Pedido de assinatura**, **Número do pedido na assinatura**, **Pedido inicial**, **Pedido recorrente**, **Número da renovação da assinatura**. 3. Aguarde alguns minutos. As tags também são adicionadas aos seus assinantes e pedidos de assinatura existentes, não só aos novos. 4. Na sua ferramenta de e-mail, crie um segmento a partir da tag. A maioria das ferramentas de e-mail que se conectam à Shopify importa as tags de cliente; confira na ajuda da sua ferramenta onde elas aparecem. Você pode alterar o texto de cada tag na mesma página. Exemplos: * **Assinantes ativos:** clientes com a tag "tem assinatura ativa". * **Compradores únicos que nunca assinaram:** clientes sem a tag "tem contrato de assinatura". * **No Shopify Email ou em um segmento de clientes da Shopify:** `customer_tags CONTAINS 'has active subscription'`. * **Distinguir primeiros pedidos de renovações** (por exemplo, em um app de afiliados): as tags de pedido **Pedido inicial** e **Pedido recorrente**. A lista completa está em [Configurações de tags](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/tag-settings-1p7ox3c/). **Nossos próprios e-mails:** o app envia e-mails de assinatura por conta própria (por exemplo, de próxima renovação e de pagamento com falha). Ele não envia e-mails em massa nem de marketing, então use sua ferramenta de e-mail para campanhas. Se sua ferramenta de e-mail envia uma versão própria de um dos nossos e-mails, desative o nosso em [**Configurações > Notificações > Notificações para clientes**](https://admin.shopify.com/apps/super-subscriptions/app/settings/notifications/customer) para que os clientes não recebam os dois. Se essa ferramenta for o Klaviyo e você usa a conexão abaixo, deixe o nosso ativado: a conexão já envia cada mensagem por um lado só, e uma notificação desativada aqui também não é enviada ao Klaviyo. Veja [Notificações](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/notifications-h8mmnz/). ###### Enviar eventos de assinatura ao Klaviyo Conecte o Klaviyo em [**Supr Bundles & Subscriptions > Configurações > Integrações > Klaviyo**](https://admin.shopify.com/apps/super-subscriptions/app/settings/integrations/klaviyo). Ele está disponível para todos os lojistas. 1. No Klaviyo, vá em **Settings > Account > API keys** e crie uma **Private API key**. **Full Access** funciona. Se você escolher **Custom**, defina **Events** como **Full** e **Accounts** como **Read**. Uma chave **Read-Only** não consegue enviar eventos. O Klaviyo não permite alterar o acesso de uma chave depois, então, se você escolheu o errado, crie uma nova chave. 2. Na página **Klaviyo** do app, cole a chave em **Chave de API privada** e clique em **Conectar**. A página mostra **Conectado** com o nome da sua conta do Klaviyo. 3. Em **Quem envia os e-mails aos clientes**, escolha uma opção: * **Supr Bundles & Subscriptions**: continuamos enviando todos os e-mails aos clientes. Este é o padrão. * **Klaviyo**: deixamos de enviar e-mails aos clientes e enviamos os eventos ao Klaviyo. * **Escolher por notificação**: marque as que o Klaviyo deve enviar, e continuamos enviando as demais. 4. Clique em **Salvar**. Se isso passar e-mails para o Klaviyo, o app pede confirmação e lista os e-mails que deixam de vir de nós. Crie e ative o fluxo antes: o Klaviyo aceita nossos eventos com ou sem um fluxo escutando, então o cliente não recebe nada até o fluxo estar ativo. 5. Em **Testar um evento**, escolha uma notificação e uma assinatura (ou nossa assinatura de exemplo) e clique em **Enviar evento de teste**. O teste é endereçado ao e-mail de contato da sua loja, não a um cliente, e é marcado com `test: true`. Ele funciona antes de você trocar o remetente, então você pode criar seus fluxos primeiro. 6. No Klaviyo, crie um fluxo para cada evento com um acionador de métrica. Cada notificação chega como uma métrica própria, como **Subscription Started**, **Subscription Renewing Soon** ou **Subscription Payment Failed**, e a página lista o nome de cada uma. Uma métrica aparece no Klaviyo depois que o primeiro evento dela chega, e é para isso que serve o teste. Cada evento traz a assinatura, os produtos, os totais, a data do próximo pedido e um link para o portal do cliente, então você pode montar a mensagem inteira nos seus próprios modelos e idiomas do Klaviyo. Bom saber: * Cada mensagem ao cliente vem de nós ou do Klaviyo, nunca dos dois. * As notificações para a equipe e os botões **Enviar uma cópia para mim** continuam vindo de nós em qualquer caso. * Uma notificação desativada em **Configurações > Notificações** fica desativada em todo lugar, inclusive no Klaviyo. Ative-a lá primeiro. * Se o Klaviyo rejeitar um evento, por exemplo porque a chave foi excluída, enviamos ao cliente o nosso próprio e-mail, e a página do Klaviyo mostra **O Klaviyo rejeitou o último evento** com um botão **Verificar a chave novamente**. * **Desconectar** exclui sua chave e voltamos a enviar os e-mails aos clientes por conta própria. ### Shopify Flow **Sim, você pode usar o Shopify Flow.** O app não adiciona acionadores próprios, e por isso você não o encontra na lista de apps do Flow. Use os acionadores de assinatura da própria Shopify: como o app usa os contratos de assinatura da Shopify, eles disparam para as assinaturas criadas com ele. * **Subscription contract created**: uma nova assinatura, por exemplo para enviar um e-mail diferente por produto. * **Subscription contract updated**: uma assinatura alterada. * **Subscription billing attempt success**, **Subscription billing attempt failure** e **Subscription billing attempt challenged**: uma cobrança de renovação. * **Customer tags added**: combinado com nossas tags de cliente, por exemplo para reagir quando um cliente recebe a tag "tem assinatura cancelada". A lista de acionadores da Shopify: [Acionadores do Shopify Flow](https://help.shopify.com/en/manual/shopify-flow/reference/triggers). Teste seu fluxo de trabalho com uma assinatura de teste antes de depender dele. ### Apps de processamento de pedidos e 3PLs **Sim, cada renovação cria um pedido que seu app de processamento de pedidos pode enviar.** * **Pagamento por entrega:** quando uma cobrança de renovação é bem-sucedida, um novo pedido da Shopify é criado e vinculado à assinatura. Os apps de processamento de pedidos, 3PLs e sistemas de armazém que buscam pedidos da Shopify o recebem como qualquer outro pedido. Uma cobrança com falha não cria pedido até ser bem-sucedida. * **Pré-pago:** o cliente paga uma vez por várias entregas. As entregas seguintes são agendadas no pedido original e ficam prontas para processamento na data delas. Pergunte ao seu provedor de logística se ele trata os processamentos agendados da Shopify antes de lançar opções de assinatura pré-paga. Veja [Quando os clientes são cobrados e quando os pedidos são processados](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/when-customers-are-charged-vs-when-orders-are-fulfilled-1y0mafy/). Para que um armazém ou 3PL distinga os pedidos de assinatura, ative as tags de pedido em **Configurações > Tags** (veja acima). Para planejar o estoque das próximas renovações, veja [Planejador de estoque](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/inventory-planner-ri7ofz/). ### Shopify POS O app **não tem integração com o Shopify POS**. O widget e as opções de kit foram feitos para a sua loja virtual, e não confirmamos que as assinaturas ou os preços das opções de kit funcionam no caixa. As regras da própria Shopify para vender assinaturas presencialmente estão em [Vender assinaturas no Shopify POS](https://help.shopify.com/en/manual/sell-in-person/shopify-pos/payment-management/subscriptions). Se você precisa vender assinaturas ou kits na loja física, fale com o suporte antes de se planejar em torno disso e adicione um pedido na página [**Solicitações de recursos**](https://admin.shopify.com/apps/super-subscriptions/app/feature-requests) para vermos quantos lojistas precisam disso. ### Headless, Hydrogen e tokens da Storefront API As lojas headless **não têm suporte oficial**. O widget, as opções de kit e a incorporação de app fazem parte do tema da sua loja virtual, então não aparecem em uma loja Hydrogen ou outra vitrine personalizada. O restante do app funciona normalmente, porque não depende da sua vitrine: renovações, cobrança recorrente após falha, notificações e tudo em **Assinaturas**. Para vender assinaturas em uma loja headless, um desenvolvedor cria a escolha na sua própria página de produto: * As **assinaturas** são as opções de compra da própria Shopify (a Shopify as chama de selling plans na API). Seu desenvolvedor as lê do produto e adiciona a escolhida à linha do carrinho pela Storefront API da Shopify. * Os **preços das opções de kit** ainda se aplicam no checkout se as linhas do carrinho tiverem as propriedades corretas, veja [Usar descontos de kit com um adicionar ao carrinho personalizado](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/bundle-types-quantity-breaks-buy-x-get-y-fixed-bundles-and-build-a-box-q04e6x/#3-usando-descontos-de-kit-com-um-adicionar-ao-carrinho-personalizado). **Onde obtenho um token de acesso da Storefront API?** Um construtor de sites (por exemplo, o Lovable) ou um front-end headless que pede um token de acesso da Storefront API precisa de um token da **Shopify**, não do nosso app. Instale o canal **Headless** da Shopify pela Shopify App Store e clique em **Create storefront** para obter um, veja o [guia de introdução à Storefront API](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/getting-started) da Shopify. A nossa API em [**Configurações > Integrações > API**](https://admin.shopify.com/apps/super-subscriptions/app/settings/integrations/api) é outra coisa: ela permite que seu próprio servidor leia e altere assinaturas, e os tokens dela nunca devem ser colocados em uma vitrine ou navegador. Veja [Usar a API](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/using-the-api-1bkxr3t/). ### Construtores de páginas, como PageFly e GemPages **As páginas de produto criadas com um construtor de páginas** (PageFly, GemPages, Shogun e outros) funcionam como as páginas de produto do tema: com o widget ligado, a incorporação de app o posiciona sozinha acima do botão de adicionar ao carrinho. **Landing pages, a página inicial e outras páginas** precisam do bloco de app **Subscriptions + Bundles** com o **Produto** definido: * Em uma página do tema, como a página inicial, adicione uma seção que mostre um produto (a maioria dos temas a chama de **Produto em destaque**) e depois **Adicionar bloco**, **Apps**, **Subscriptions + Bundles**. * No PageFly, use o elemento **App blocks** dele. Passo a passo: [Mostrar o widget em outras páginas](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/how-to-enable-the-subscription-widget-in-the-online-store-1lpw08p/#3-mostrar-o-widget-em-outras-paginas) e [PageFly e outros construtores de páginas](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/how-to-enable-the-subscription-widget-in-the-online-store-1lpw08p/#3-pagefly-e-outros-construtores-de-paginas). Se o elemento de app do seu construtor não lista **Subscriptions + Bundles** (lojistas relataram isso em landing pages do GemPages), ou o widget cai no lugar errado, fale com o suporte enviando o link da página. ### Apps de teste A/B e de teste de preços O app tem **teste A/B integrado** de ofertas: em [**Crescimento > Testes A/B**](https://admin.shopify.com/apps/super-subscriptions/app/grow/ab-tests) você pode mostrar aos compradores de duas a quatro versões de uma oferta, com descontos, opções ou textos diferentes, e manter a que rende mais por visitante. Os designs de widget ainda não podem ser testados. Para qualquer outra coisa, como páginas inteiras ou preços de produtos, você pode usar um app de teste A/B de terceiros. Não testamos esses apps com o widget. Lembre-se de que, se um app de teste de preços altera os preços com um desconto automático próprio, a Shopify cobra apenas o maior entre esse desconto e o nosso em cada linha do carrinho, o que altera os preços dos seus kits. Faça um pedido de teste em cada versão do teste antes de rodá-lo em produtos que têm uma oferta. ### Temas O widget funciona com os temas da Shopify pela **incorporação de app**: 1. Vá em [**Supr Bundles & Subscriptions > Design**](https://admin.shopify.com/apps/super-subscriptions/app/widget) e clique em **Ativar widget**. 2. O editor de temas abre com a incorporação de app ligada. Clique em **Salvar** ali. A incorporação posiciona o widget acima do botão de adicionar ao carrinho sozinha. O bloco de tema **Subscriptions + Bundles** é opcional, para uma posição exata ou para páginas que não são de produto. Quando o bloco está em uma página, a cópia da incorporação se remove sozinha, então usar os dois não mostra o widget duas vezes. Mantenha a incorporação de app ligada. Veja [Como ativar o widget de assinatura](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/how-to-enable-the-subscription-widget-in-the-online-store-1lpw08p/). Você muda a aparência do widget na página Design, veja [O widget de assinatura](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/the-subscription-widget-l9335l/). **Se algo parecer ou se comportar de forma errada no seu tema** (desalinhado, um preço errado, o texto do botão de adicionar ao carrinho duplicado, assinaturas adicionadas como compra única, quebrado no celular), confira primeiro: * **Texto do botão de adicionar ao carrinho duplicado ou estranho:** desative o complemento **Texto do botão de adicionar ao carrinho** na página Design, veja [Complementos da página de produto](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/product-page-add-ons-1b9e1n3/#3-texto-do-botao-de-adicionar-ao-carrinho). * **Assinaturas adicionadas como compra única:** teste com o botão principal de adicionar ao carrinho, não com uma barra fixa de adicionar ao carrinho nem com um botão de compra rápida, e desligue outros apps de carrinho ou de adicionar ao carrinho por um momento. Veja [As assinaturas não estão sendo adicionadas ao carrinho](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/subscriptions-are-not-adding-to-cart-1nf6714/). * **Pop-ups de adição rápida ou visualização rápida:** alguns temas mostram o widget dentro do pop-up, outros não, e alguns abrem a página do produto no lugar, nos produtos com assinatura. Se o seu adiciona o produto sem mostrar o widget, desative a adição rápida nas configurações do tema para que os compradores escolham na página do produto. * **Widget exibido duas vezes ou no fim da página:** veja [O widget de assinatura aparece duas vezes ou no fim da página](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/the-subscription-widget-appears-twice-or-at-the-bottom-of-the-page-21b9cb/). * **É o tema?** Adicione um tema gratuito da Shopify, como Horizon ou Dawn, em **Loja virtual > Temas** (não precisa publicá-lo), ligue **Supr Bundle & Subscriptions** em **Incorporações de app** no editor desse tema e visualize o mesmo produto. Se o problema sumiu ali, ele vem do seu tema ou de outro app. Ainda com problema? Fale com o suporte enviando o link do produto, o nome do seu tema e uma gravação de tela curta. Se sua loja é protegida por senha, inclua a senha, veja [Como compartilhar a senha da sua loja virtual com o suporte](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/how-to-share-your-online-store-password-with-support-13gqmu3/). Os conflitos de tema costumam ter solução do nosso lado, e vamos investigar. ### Perguntas frequentes * **Posso usar o Kaching Bundles (ou outro app de kits) com as suas assinaturas no mesmo produto?** Não. Nossas assinaturas não se combinam com os kits de outro app, e os descontos de dois apps em uma mesma linha do carrinho não se somam. Monte o kit como opções de kit em uma oferta Kit + Assinatura, veja [Outros apps de kits](#3-outros-apps-de-kits-como-o-kaching-bundles). * **Preciso desinstalar meus outros apps de kits, assinaturas e upsell?** Não necessariamente, mas desligue os widgets deles nos produtos das suas ofertas e pause os descontos automáticos que sobraram. Se um app de assinaturas antigo ainda cobra assinantes, migre-os antes de desinstalá-lo, veja [Migrar para o Supr Bundles & Subscriptions](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/migrating-to-super-subscriptions-18c7rbb/). * **Meu app de seletor de variantes diz que o problema é o seu app. E agora?** As assinaturas só funcionam com variantes reais da Shopify. Se o app usa variantes reais e o widget ainda não acompanha a escolha do comprador, envie o link do produto com os dois apps ligados e vamos investigar. * **Por que aparece "The bundle product cannot be added to the cart" no meu produto do Shopify Bundles?** A Shopify não consegue colocar um produto de kit diretamente em uma assinatura, então o app adiciona os componentes dele. Confira se todos os componentes estão na mesma oferta, em estoque, e se o widget está ligado, veja [Produtos do app Shopify Bundles em assinatura](#3-produtos-do-app-shopify-bundles-em-assinatura). * **Meu app de pontos de fidelidade ainda vai dar pontos nos pedidos de assinatura?** Geralmente sim, porque as renovações são pedidos normais da Shopify. Teste com uma assinatura de teste, já que cada app de fidelidade tem as próprias regras. * **Vocês têm integração com Klaviyo ou Omnisend?** Com o Klaviyo, sim: enviamos os eventos das suas assinaturas ao Klaviyo para que você crie os e-mails como fluxos lá, veja [Enviar eventos de assinatura ao Klaviyo](#6-enviar-eventos-de-assinatura-ao-klaviyo). Com o Omnisend, não diretamente: ative nossas tags de cliente e de pedido em Configurações > Tags e crie seus segmentos a partir delas no Omnisend ou no Shopify Email. * **Por que o Supr Bundles & Subscriptions não aparece no Shopify Flow?** O app usa os acionadores de assinatura da própria Shopify, como **Subscription contract created**, em vez de adicionar os próprios. Escolha esses nos acionadores da Shopify. * **Onde obtenho um token de acesso da Storefront API para o meu site headless?** Da Shopify, não do nosso app: instale o canal Headless da Shopify e crie uma vitrine. Nossa API em Configurações > Integrações > API serve apenas para o seu próprio servidor. ### Guias relacionados * [Como o Supr Bundles & Subscriptions funciona](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/how-super-subscriptions-works-qozw1u/) * [Como funcionam os descontos de assinatura](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/how-subscription-discounts-work-1btg9f3/) * [Configurações de tags](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/tag-settings-1p7ox3c/) * [Usar a API](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/using-the-api-1bkxr3t/) * [Como ativar o widget de assinatura](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/how-to-enable-the-subscription-widget-in-the-online-store-1lpw08p/) * [Migrar para o Supr Bundles & Subscriptions](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/migrating-to-super-subscriptions-18c7rbb/) * [Quais gateways de pagamento funcionam com assinaturas](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/which-payment-gateways-work-with-subscriptions-79x1r5/) * [Vender assinaturas com B2B, Markets e várias moedas](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/selling-subscriptions-with-b2b-markets-and-multiple-currencies-17b0a43/) * [Solicitar um novo recurso](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/requesting-a-feature-osnd8e/)