Como personalizar o checkout Shopify (Checkout Extensibility)

Durante anos, as lojas Shopify Plus personalizaram o checkout editando um ficheiro, o checkout.liquid. Esse caminho acabou. Hoje o checkout só se personaliza com o Checkout Extensibility: apps, extensões, Shopify Functions, o editor de marca e pixels.

Este guia é para quem decide, não só para quem programa: o que mudou, o que cada plano permite, onde costumam estar os problemas e como fazer a migração com segurança. E responde a duas perguntas que quase todas as lojas portuguesas nos fazem: como pedir o NIF e como ter MB WAY e Multibanco no checkout.

O que é o Checkout Extensibility

É o conjunto de ferramentas com que o Shopify passou a permitir personalizar o checkout, sem mexer no código da página. Tem cinco peças:

• Checkout UI extensions: blocos visíveis no checkout, como ofertas, campos extra ou mensagens de confiança.
• Shopify Functions: lógica no servidor para descontos, métodos de envio, métodos de pagamento e validações.
• Editor de checkout e Branding API: cores, tipografia, logótipo e layout.
• Web pixels: tracking de eventos do checkout para analytics e plataformas de anúncios.
• Extensões de pós‑compra e de página de obrigado: upsells, inquéritos, pedidos de avaliação.

Tudo corre num ambiente controlado pelo Shopify. Na prática isto quer dizer um checkout mais rápido e mais seguro, atualizações automáticas e personalizações que também aparecem no Shop Pay.

O fim do checkout.liquid, por datas

• 13 de agosto de 2024: o checkout.liquid deixou de funcionar nos passos de informação, envio e pagamento.
• 28 de agosto de 2025: fim do checkout.liquid e dos scripts adicionais nas páginas de obrigado e de estado da encomenda, e fim das script tags nessas páginas para lojas Plus.
• 26 de agosto de 2026: fim das script tags nas páginas de obrigado e de estado da encomenda para as restantes lojas.

O que se pode personalizar em cada plano

• Editor de checkout (todos os planos): logótipo, cores, tipografia, fundo, layout e blocos simples como banners.
• Apps nas páginas de obrigado, estado da encomenda e conta de cliente (todos os planos): upsells pós‑compra, fidelização, inquéritos.
• Apps nos passos de informação, envio e pagamento (só Plus): mensagens de oferta, brindes, campos personalizados, banners dentro do checkout.
• Branding API (só Plus): favicon, cantos, cabeçalho, botões e cores do resumo da encomenda.
• Shopify Functions (todos os planos através de apps; Functions à medida em Plus): descontos, envios, pagamentos, validações.
• Web pixels (todos os planos): eventos do checkout para analytics e anúncios.

A grande diferença está no meio do checkout: só em Shopify Plus é possível pôr apps e blocos nos passos de informação, envio e pagamento. Para muitas marcas, é este o motivo para mudar de plano.

Checkout UI extensions: acrescentar ao checkout

São pequenos blocos de interface que aparecem em pontos definidos do checkout. Alguns exemplos que fazemos com frequência em lojas portuguesas:

• Campo de NIF para a fatura, validado antes do pagamento.
• Mensagem de embrulho ou de oferta, com pré‑visualização.
• Produtos complementares junto ao resumo da encomenda.
• Saldo de pontos do programa de fidelização.
• Mensagens de confiança perto do botão de pagamento: devoluções, prazos, apoio ao cliente.

Há dois caminhos: instalar uma app pública da Shopify App Store ou desenvolver uma app à medida. As extensões herdam a marca da loja, usam componentes do Shopify e só acedem aos dados que a loja autoriza. O que não dá é mexer na página com JavaScript, como se fazia no checkout.liquid: essas soluções têm de ser repensadas, não copiadas.

NIF, MB WAY e Multibanco no checkout Shopify

Como pedir o NIF no checkout

Em Portugal, muitos clientes querem fatura com NIF, e a fatura tem de sair de um programa de faturação certificado pela AT. O NIF pode ser pedido de várias formas:

• Em Shopify Plus, com uma checkout UI extension: um campo próprio no passo de informação, validado antes do pagamento.
• Em qualquer plano, no carrinho ou na conta de cliente, guardado na encomenda.
• Em B2B, a partir da ficha da empresa, sem o cliente ter de o escrever em cada compra.

Seja qual for o caminho, o importante é que o NIF chegue ao programa de faturação ou ao ERP com a encomenda, sem cópias à mão.

MB WAY e Multibanco

São os métodos que os portugueses mais esperam ver a seguir ao cartão. Com o Shopify Payments em Portugal, o Multibanco é ativado automaticamente e o MB WAY passou a ser um método nativo, que se ativa nas definições de pagamento. Quem não usa o Shopify Payments continua a tê‑los através de fornecedores portugueses com apps para Shopify. Explicamos tudo em Bizum e MB WAY no Shopify. Com Shopify Functions dá para escolher quando aparecem, por exemplo esconder a referência Multibanco em encomendas com entrega no próprio dia.

Shopify Functions: mudar a lógica do checkout

As Functions correm na infraestrutura do Shopify e mudam o comportamento do checkout, não o aspeto:

• Esconder um método de pagamento para certas zonas ou valores, por exemplo pagamento na entrega acima de um montante.
• Mudar o nome ou a ordem dos métodos de envio.
• Impedir a compra quando uma regra não é cumprida, como quantidades mínimas em B2B.
• Descontos por escalões, packs ou combinações de produtos.

Substituem os Shopify Scripts, o código Ruby que as lojas Plus usavam para descontos, envios e pagamentos. A lógica dos Scripts não se copia: tem de ser reescrita como Functions. Muitas necessidades já estão cobertas por apps; o desenvolvimento à medida só é preciso para regras únicas.

Marca do checkout: editor primeiro, API se for preciso

Comece pelo editor de checkout: não precisa de código e as alterações passam também para o Shop Pay. A Branding API, em Plus, dá controlo mais fino, mas a maioria das marcas resolve tudo no editor.

Decida cedo entre checkout numa página ou em três passos. O layout muda os sítios onde as extensões podem aparecer, por isso convém fechar isto antes de desenhar os blocos.

Páginas de obrigado e de estado da encomenda

Era aqui que estava a maior parte das personalizações antigas e foi aqui que caíram os últimos prazos. Tudo o que estava em scripts adicionais ou script tags tem de passar para:

• App blocks, para conteúdo: informação de entrega, pedidos de avaliação, convites de referência.
• Extensões de pós‑compra, para upsells com um clique.
• Web pixels, para o tracking de conversões.

As páginas de conta de cliente usam agora o mesmo sistema, por isso uma experiência de fidelização ou de devoluções pode continuar do checkout para a área de cliente.

Pixels e tracking depois do checkout.liquid

É a parte da migração que mais falha sem ninguém dar por isso. O tracking passa a correr através de customer events e web pixels, num ambiente isolado que respeita o consentimento de cookies. Isto tem consequências:

• Tags que liam dados da página, como o valor da encomenda, deixam de funcionar.
• O consentimento decide se os pixels disparam. Um banner de cookies mal configurado pode esconder conversões, o que em Portugal e na UE, com o RGPD, é um risco real.
• O Google Tag Manager tem de entrar como pixel personalizado, ou ser substituído pelas apps nativas da Google, Meta e TikTok.

Como migrar, passo a passo

1. 01Fazer o inventário de tudo o que está no checkout.liquid, scripts adicionais, script tags e Shopify Scripts. O guia de atualização do Shopify não apanha o que entra pelo Tag Manager.
2. 02Classificar cada item: ainda é preciso? Já existe de origem? Há uma app? Precisa de extensão ou Function à medida? Muitas coisas já não fazem falta.
3. 03Construir num perfil de checkout de rascunho e pré‑visualizar antes de publicar.
4. 04Refazer o tracking com pixels e testar cada evento de compra.
5. 05Passar a página de obrigado para app blocks e extensões de pós‑compra.
6. 06Testar de ponta a ponta com encomendas reais: códigos de desconto, cartões‑oferta, Shop Pay, MB WAY, Multibanco e cartão, sobretudo em mobile.
7. 07Publicar e acompanhar durante duas semanas a conversão, os pagamentos aceites e as conversões registadas.

Erros a evitar

• Refazer tudo um para um, em vez de aproveitar para tirar o que já não serve.
• Deixar o tracking para o fim.
• Instalar várias apps que acrescentam blocos ao checkout e o tornam mais lento.
• Esquecer as contas de cliente, que agora fazem parte do mesmo sistema.
• Mudar muitas coisas ao mesmo tempo: se a conversão cair, não se sabe porquê. Quando o tráfego permite, vale a pena testar as alterações.

Perguntas frequentes

Migramos e desenvolvemos checkouts em lojas Shopify Plus, de extensões à medida a Functions e tracking. Se quer rever o seu checkout, fale connosco.