Guia de atualização para Checkout Extensibility
O Shopify Checkout permite aceitar pedidos e receber pagamentos onde quer que você venda online. Caso sua loja esteja no plano Shopify Plus, o Checkout Extensibility poderá ser usado para adicionar apps e fazer personalizações avançadas de branding. Tudo isso sem entrar em conflito com upgrades e de modo a funcionar com o Shop Pay.
Neste guia, quem tem uma loja com o plano Shopify Plus vai ver novas maneiras de usar o recurso Extensibilidade de checkout para personalizar as páginas de checkout, agradecimento e status de pedidos na Shopify. Use o Kit de atualização para a extensibilidade do checkout e saiba mais sobre como avaliar e substituir as personalizações atuais.
Nesta página
Sobre o Checkout Extensibility
Se você quer personalizar o checkout, precisa saber que o checkout.liquid
está aquém do Checkout Extensibility, que é mais rápido, mais seguro, tem desempenho melhor, não entra em conflito com atualizações e funciona perfeitamente com o Shop Pay. Quem resolve fazer upgrade para essa ferramenta aproveita diversos novos recursos e funcionalidades, como:
- Personalizações de checkout
- Editor de checkout e contas
- Pixels da Shopify
- API Branding
- Campos de endereço adicionais no checkout
Vale lembrar que o Checkout Extensibility permite criar personalizações para checkout integradas a apps de instalação fácil, que não entram em conflito com atualizações. Além disso, está sempre evoluindo para atender às suas necessidades com recursos novos ou aprimorados, junto aos apps recém-desenvolvidos.
Qualificação
É necessário ter uma loja no plano Shopify Plus para usar o Checkout Extensibility. Além disso, alguns recursos são incompatíveis e não podem ser usados, como estes:
- Mutações da API In Flight
- Gateways de pagamento hospedados incompatíveis com o SDK
Impacto por perder o prazo de 13 de agosto de 2024
O prazo para fazer upgrade do checkout.liquid
para o Checkout Extensibility nas páginas de Informações, Frete e Pagamentos era o dia 13 de agosto de 2024. O Checkout.liquid
está obsoleto e não recebe atualizações de funcionalidades desde 2021. Com as constantes mudanças nas regulamentações no mundo inteiro, incluindo a introdução de regras do setor de cartões no âmbito da PCI DSS v4, o checkout.liquid
é menos seguro que o Checkout Extensibility, e é necessário descontinuar a compatibilidade.
A partir de 14 de agosto de 2024, quando o processo de desativação completa do checkout.liquid
foi iniciado nas páginas Informações, Frete e Pagamentos, as lojas que não estiverem atualizadas enfrentarão os seguintes impactos:
-
As personalizações do
Checkout.liquid
estão bloqueadas: a Shopify não vai mais disponibilizar atendimento ao cliente para atualizar ou corrigir personalizações feitas com checkout.liquid nas páginas Informações, Frete e Pagamento. Dessa forma, não será possível editá-las. As lojas que continuarem a usar esse código obsoleto após o prazo final o farão por sua própria conta e risco. - Os gateways de pagamento estão bloqueados: a capacidade de desativar gateways de pagamento ou trocar de provedor está desabilitada.
- Os indicadores de risco de pedidos estão desativados: com a execução de código sem sandbox no checkout, não é possível fazer uma avaliação de risco confiável e precisa. Por isso, indicadores de fraude e recomendações não são mais disponibilizados no admin para novos pedidos.
- Pagamentos mais lentos no Shopify Payments: como os pedidos serão considerados de alto risco, os pagamentos podem atrasar em até cinco dias após o processamento da transação.
A partir de 6 de janeiro de 2025, vamos iniciar o upgrade automático dos checkouts que ainda usam o checkout.liquid
. Um aviso será enviado por e-mail 30 dias antes. Isso significa que:
- As páginas Informações, Frete e Pagamento voltarão ao estado-padrão, perdendo todas as personalizações feitas com o
checkout.liquid
. - a vitrine continuará a processar pedidos, mesmo sem essas personalizações;
- as configurações de marca definidas no editor de temas da loja virtual serão aplicadas automaticamente ao checkout-padrão. No entanto, as personalizações visuais feitas com arquivos .liquid ou arquivos customizados JavaScript e CSS associados não serão carregadas.
Atenção, lojas do Shopify Plus! O prazo para fazer upgrade do checkout.liquid
para o Checkout Extensibility nas páginas Agradecimento e Status do pedido é 28 de agosto de 2025. Isso também inclui atualizar apps que usam tags de script e substituir scripts adicionais por apps que usam extensões de IU para checkout e Pixels da Shopify nessas páginas. Os Scripts da Shopify também serão desativados nessa data, mas continuarão funcionando junto com o Checkout Extensibility até lá. Portanto, os scripts precisam ser trocados por Shopify Functions antes dessa data.
Atualizar para Checkout Extensibility
Há um relatório automático no admin da Shopify que identifica as personalizações existentes no checkout e está disponível para download como arquivo CSV. Use esse relatório para simplificar a análise das personalizações de checkout existentes e fazer upgrade para o Checkout Extensibility mais rapidamente.
Ainda é possível fazer upgrade para o Checkout Extensibility, mesmo que você não consiga replicar todas as personalizações existentes de checkout.liquid
, scripts adicionais e apps. É possível fazer upgrade de todas as páginas ou apenas as do checkout na hora de publicar.
Etapa 1: analisar as personalizações existentes no checkout
No admin da Shopify, acesse Configurações > Checkout.
-
Na seção Fazer upgrade para Extensibilidade de checkout, clique em Analisar personalizações para abrir o relatório com informações sobre personalizações existentes no checkout, incluindo os seguintes dados:
- Categoria de personalização (como Branding ou Validações)
- Nome e descrição da personalização
- Arquivo de origem, como
checkout.liquid
- Linhas de código onde a personalização começa e termina
- Orientação para criar a personalização no Checkout Extensibility
Opcional: para fazer download de uma versão do relatório como um arquivo CSV, clique em ↥ Exportar.
Saiba mais sobre o layout do checkout.liquid
.
Etapa 2: analisar as personalizações das páginas de agradecimento e status de pedidos
Analisar personalizações criadas por scripts adicionais
Para analisar as customizações atuais criadas com scripts adicionais na página de status do pedido, acesse o relatório personalizado.
No admin da Shopify, acesse Configurações > Checkout.
Na seção Fazer upgrade para extensibilidade de checkout, clique em Analisar personalizações.
-
Na página do relatório Personalizações, você receberá uma análise dos scripts adicionais, incluindo estes dados:
- Categoria de personalização, como Pixels de conversão ou Rastreamento do pedido
- Nome e descrição da personalização
- Arquivo de origem, como scripts adicionais
- Orientação para recriar a personalização no editor de checkout e contas
Analisar personalizações criadas por apps
Para continuar a usar as personalizações criadas com apps nas páginas de agradecimento e status do pedido, o app precisa ser atualizado pelo desenvolvedor para que você possa recriar personalizações que usem blocos e pixels. No caso dos apps que foram atualizados pelo desenvolvedor, siga as instruções de configuração para começar. Você pode entrar em contato com o desenvolvedor a respeito de apps que ainda precisam de atualização e ainda não estão prontos para serem configurados.
Saiba mais sobre como personalizar o checkout com apps.
No admin da Shopify, acesse Configurações > Checkout.
Na seção Fazer upgrade para extensibilidade de checkout, clique em Analisar personalizações.
-
Na página do relatório Personalizações, você receberá uma lista de apps dividida nos seguintes tipos:
- Apps que foram atualizados pelo desenvolvedor e estão prontos para você configurar e recriar suas personalizações.
- Apps que exigem uma atualização por parte do desenvolvedor do app antes que você possa configurá-los e recriar suas personalizações. Você pode entrar em contato diretamente com o desenvolvedor do app para obter mais informações.
Etapa 3: criar e publicar novas personalizações
No admin da Shopify, acesse Configurações > Checkout.
Na seção Configurações, clique em Criar rascunho.
Adicione apps ou edite o branding para personalizar as páginas de checkout, agradecimento e status de pedidos. Saiba mais sobre como personalizar e editar o checkout.
Opcional: configure os pixels ou os recursos adicionais próprios.
Analise as alterações.
Quando estiver tudo pronto para usar o novo checkout, clique em Publicar.
Na janela pop-up, escolha as páginas e clique em Publicar para confirmar se quer substituir as personalizações ativas.
O checkout é atualizado automaticamente sempre que a Shopify faz novas melhorias.
Opcional: instalar apps para checkout
Considere instalar alguns dos apps de checkout da Shopify App Store para aprimorar o checkout com funcionalidades adicionais, que ajudam a aumentar as conversões, elevar o valor do ticket médio e muito mais. O Checkout Blocks é um app gratuito que oferece uma ampla variedade de personalizações simples, mas há muitos outros disponíveis na Shopify App Store.
Opcional: configurar os pixels
Se você usa checkout.liquid
para acompanhar eventos dos clientes, precisará substituí-lo pelos Pixels antes de publicar o rascunho de checkout.
Opcional: configurar recursos adicionais próprios
É possível que algumas de suas personalizações no checkout.liquid
sejam compatíveis com a Shopify. Portanto, antes de publicar o rascunho do checkout, analise e configure esses recursos conforme o caso.
Os recursos agora compatíveis com a Shopify incluem os seguintes exemplos:
Reverter para checkout.liquid, scripts adicionais ou apps com tags de script
Etapas:
- Em Configurações > Checkout, na seção Atualizar status, clique no link para reverter.
- Selecione as páginas em questão e clique em Reverter.
Depois que você reverte, as personalizações de Extensibilidade do checkout são salvas como rascunho e podem ser atualizadas e publicadas posteriormente.
Se você começar a usar recursos incompatíveis com checkout.liquid
e retornar ao checkout.liquid
, esses recursos deixarão de funcionar.
Recursos incompatíveis com checkout.liquid
A maioria dos recursos introduzidos desde 2023 não são compatíveis com o checkout.liquid
e só ficam disponíveis quando você faz upgrade para o Checkout Extensibility. Alguns incluem os seguintes exemplos:
- Extensões de IU para checkout
- B2B
- Shop Cash
- Experimente antes de comprar
- Pré-vendas
- Shopify Functions
- Pacotes de produtos
- Checkout de uma página
- Edição de pedido em moeda local
- Captura automática de pagamento por processamento de pedidos
- Pacotes em rascunhos de pedido
- Captura de ID de tributos no checkout
- Campos de endereço específicos para a região nos checkouts
- Separar frete no checkout
- Pixels da web