Preço da assinatura nas Checkout UI Extensions da Shopify

Uma extensão de interface do checkout (checkout UI extension) da Shopify não consegue reescrever o preço recorrente que um assinante vê no checkout. Esse número vem da política de preços (pricing policy) do plano de venda (selling plan), então quando parece errado depois de uma troca de produto, a correção é feita no plano, não na extensão.

Um lojista com uma assinatura de velas viu o Recurring Subtotal mostrar sempre o preço inicial, mesmo depois de clientes trocarem para uma variante de reposição mais barata, como descrito em um tópico da Comunidade Shopify. Vemos a mesma confusão na nossa própria fila de suporte: 13 perguntas sobre checkout de assinaturas em 90 dias, incluindo lojistas sem saber o que o checkout promete versus o que é realmente cobrado.

De onde realmente vem o preço recorrente

A Shopify organiza produtos de assinatura em grupos de planos de venda (selling plan groups). Cada plano tem uma política de preços, que tem dois formatos: fixed, um único ajuste para toda a assinatura, ou recurring, um ajuste diferente depois do fim de um período inicial. O checkout lê diretamente da política vinculada àquela linha.

As extensões de interface do checkout ficam ao lado desse número, não dentro dele. A Shopify as documenta como blocos ou conteúdo estático colocado antes ou depois das seções do checkout. O cálculo do preço é feito separadamente pelo Shopify Functions, não por uma extensão de interface.

Se você ainda não auditou suas extensões de checkout e conta desde o último prazo, esse é um bom ponto de partida antes de adicionar mais uma.

Duas coisas que as pessoas chamam de "troca de produto"

Separe esses dois casos antes de investigar: uma mudança de ciclo embutida no plano, como preço inicial da vela e depois preço de reposição sem nenhuma ação do cliente, e uma troca manual de produto feita pelo comprador no meio da assinatura. O caso do fórum citado acima é do primeiro tipo. Uma troca manual é uma ação diferente, mas atualiza o mesmo objeto de política de preços por baixo.

A auditoria: descubra o que está quebrado

1. Busque o plano de venda por trás do produto, no painel do seu app de assinaturas ou pela consulta Admin GraphQL sellingPlanGroups, e veja suas políticas de preços.
2. Verifique se ele tem uma política ou duas. Apenas uma política significa que os dois ciclos vão mostrar e cobrar o mesmo valor, por design.
3. Se você espera dois preços, adicione a política recurring que falta pelo seu app de assinaturas, para que o primeiro ciclo cobre o preço inicial e os ciclos seguintes o preço da troca.
4. Salve a mudança, faça um pedido de assinatura teste real e confira a primeira cobrança futura dentro do seu app de assinaturas antes de dizer a alguém que o problema foi resolvido.
5. Se as duas políticas já estiverem corretas e o checkout ainda parecer confuso, é um problema de texto, não de preço. Vá para a próxima seção em vez de editar o plano de novo.

Por que vale a pena corrigir isso antes da próxima migração

Um assinante que vê um preço no checkout e outro na fatura costuma cancelar ou abrir uma contestação de pagamento. Isso costuma aparecer justamente quando lojas migram de app de assinatura.

Também já vimos tickets de suporte em que métodos de pagamento quebravam de forma independente do preço, por exemplo uma pergunta sobre "iDEAL/Mollie payments not working" depois de uma troca de provedor. É uma falha separada, que vale a pena checar à parte.

Se você está avaliando se uma migração vale a pena, nosso detalhamento dos custos de assinatura cobre as taxas que a maioria das lojas deixa passar.

Quando o número está certo mas o texto não

Apps construídos sobre o modelo de preços nativo da Shopify guardam uma troca do mesmo jeito que a Shopify. O Progus Subscriptions, por exemplo, mantém as políticas de preços de cada plano como pares de tipo de ajuste e valor de ajuste, o mesmo objeto que o checkout lê, então a auditoria acima funciona da mesma forma independentemente de qual app gerencia a assinatura.

Se o valor cobrado já está correto e você só quer contexto extra antes da troca, um desenvolvedor pode adicionar uma extensão de interface do checkout perto do resumo do pedido. Ela pode ler um preço futuro salvo em um metafield e mostrá-lo como uma nota. Essa nota não muda a linha Recurring Subtotal, só responde à pergunta ao lado dela.

A Shopify limita extensões de interface do checkout nas etapas de informações, envio e pagamento a lojas no plano Shopify Plus. Extensões perto do resumo do pedido seguem um tipo de alvo diferente, então confirme sua posição exata antes de prometer isso a alguém.

Considerações finais

Extensões de interface do checkout são uma camada de apresentação, não um motor de preços. Quando um número parecer errado, verifique primeiro a política de preços do plano de venda, e só construa uma extensão personalizada depois de confirmar que o valor cobrado em si está correto.

Apps de assinatura mudam por aquisições, migrações e provedores que descontinuam recursos, com mais frequência do que a maioria dos lojistas espera. Teste novamente a política de preços e a configuração do método de pagamento separadamente depois de qualquer um desses eventos, porque um pode quebrar sem o outro.