Use Shopify Functions quando a necessidade for executar lógica de backend em um target suportado, como certas transformações ou validações. Use Checkout UI Extensions quando for preciso renderizar interface, orientar o comprador ou coletar dados nos pontos de extensão disponíveis. Muitas soluções combinam as duas abordagens, mas plano, target, dados, permissões, app e testes determinam a elegibilidade do caso concreto.
Diferencie regra de backend de interface no checkout
Shopify Functions é uma forma de personalizar lógica de backend: o Shopify invoca a função quando necessário em um target configurado, usando entrada e saída definidas pelos schemas da API. Já Checkout UI Extensions adiciona interface e lógica no ambiente do checkout, por exemplo para mensagem, campo, feedback ou experiência de agradecimento. Este artigo não substitui as páginas específicas de Functions, UI Extensions ou Checkout Extensibility; ele organiza a decisão entre lógica e UI. Antes de escolher tecnologia, escreva o comportamento desejado e classifique se ele precisa calcular, transformar, validar, exibir, coletar ou orientar.
Combine abordagens apenas quando cada uma tem função clara
Uma mesma jornada pode precisar de regra e interface, mas isso não obriga a usar duas extensões. Por exemplo, uma regra pode ser processada no backend e uma UI pode explicar uma escolha, coletar um atributo permitido ou exibir retorno ao comprador. A divisão precisa respeitar os dados e as operações disponíveis em cada target. Checkout UI Extensions usam componentes e APIs expostos pela Shopify; elas não acessam o HTML da página nem informações sensíveis de pagamento. Evite transferir uma decisão de elegibilidade para o navegador quando a regra exige uma API de backend suportada.
Valide plano, target, app, dados e permissões
A documentação atual informa que apps públicos da App Store com Functions podem ser usados por lojas de qualquer plano, enquanto apps personalizados que contêm APIs de Shopify Functions exigem Shopify Plus; certas capacidades de Functions também têm restrições próprias. Para UI Extensions, os passos de informação, frete e pagamento do checkout são indicados como disponíveis para Shopify Plus. Além do plano, confirme target, API version, distribuição do app, configurações, metafields e acesso a dados protegidos. Uma capacidade documentada não prova elegibilidade de toda conta, mercado ou combinação de app e provedor.
Teste comportamento, limites e operação futura
Teste a solução nos cenários que justificam a customização, com comprador, carrinho, método e configuração representativos. UI Extensions podem aplicar mudanças por APIs específicas, mas a documentação alerta que limites de taxa podem impedir mudanças adicionais na sessão; agrupar apenas as mudanças necessárias reduz risco. Elas rodam em sandbox isolado e têm acesso limitado a APIs, exigindo atenção a dependências e relatórios de erro. Para Functions, teste a lógica com as entradas permitidas e o comportamento do target. Não confunda teste local ou de desenvolvimento com homologação completa de produção.
Fontes
Conteúdo revisado pela Buda Digital em .