Introdução à API pública do Upcart

A API pública do Upcart permite personalizar seu carrinho, automatizar fluxos de trabalho e integrar com apps de terceiros — seja você um desenvolvedor ou alguém que está apenas começando.
Este guia apresenta o básico e ajuda você a começar a criar funcionalidades personalizadas dentro do seu cart drawer. 👉 Ver a documentação completa da API pública do Upcart

Visão geral

A API pública é uma coleção de funções JavaScript e listeners de eventos que permitem:

Reagir a mudanças no carrinho — detectar quando itens são adicionados, removidos ou atualizados.
Acionar ações — como abrir ou fechar o carrinho de forma programática.
Criar recursos personalizados — injetar sua própria lógica ou componentes de UI diretamente dentro do cart drawer.

Ela é especialmente útil ao trabalhar na seção Custom HTML do editor do Upcart, onde você pode usar essas funções para criar experiências únicas para os compradores.

O que você precisa para começar

Antes de usar a API do Upcart, certifique-se de ter:

Acesso ao Upcart na sua loja Shopify
Garanta que o Upcart esteja instalado e ativo na sua loja.
Um entendimento básico de JavaScript
Muitas personalizações usam trechos pré-escritos, mas conhecer o básico de JavaScript ajuda se você quiser ir além do básico.

Adicionando seu primeiro script da API do Upcart

Você pode começar a usar a API diretamente do seu editor do Upcart:

Vá para Upcart Editor → Settings → Custom HTML → Scripts (before load)
Cole seu script — por exemplo:

<script>
  window.upcartSubscribeAddedToCart(function(event) {
    console.log("You just added " + event.item.title + " to your cart!");
  });
</script>

Nota: exemplos mais antigos usando window.upcartOnAddToCart ainda funcionam, mas estão obsoletos e registram um aviso no console. Use upcartSubscribeAddedToCart em todos os novos scripts.

Salve suas alterações e depois teste na sua loja:

Abra as Dev Tools (F12 ou Ctrl + Shift + J no Windows, Cmd + Option + J no Mac)
Adicione um produto ao seu carrinho
Verifique na aba Console a mensagem:
"You just added [product title] to your cart!"

🎉 Se você viu a mensagem, seu primeiro script de API está funcionando!

Comece a personalizar seu carrinho

Agora que você está com tudo configurado, pode usar a API para fazer todo tipo de coisa legal — como abrir automaticamente o carrinho quando itens são adicionados, atualizar widgets personalizados ou enviar eventos de análise. Para referências completas de funções e exemplos, consulte a documentação da API pública do Upcart.

Mais recursos

🧩 FAQ da API — Dicas de solução de problemas e perguntas comuns
⚙️ Usos comuns da API do Upcart — Exemplos de código e modelos populares
💡 Documentos de personalização — Scripts pré-escritos para ajudar você a começar rápido
🛍️ Documentação da Cart API do Shopify — Saiba como o Shopify lida com os dados do carrinho nos bastidores
👩💻 Precisa de personalizações avançadas? Considere contratar um Shopify Expert para integrações mais complexas.

Primeiros passos

Módulos do carrinho

Configurações do carrinho

Botão de carrinho fixo

Multicart

Personalizações

Análises

Integrações e compatibilidade

Faturamento e conta

Solução de problemas

Visão geral

O que você precisa para começar

Adicionando seu primeiro script da API do Upcart

Comece a personalizar seu carrinho

Mais recursos

​Visão geral

​O que você precisa para começar

​Adicionando seu primeiro script da API do Upcart

​Comece a personalizar seu carrinho

​Mais recursos

Visão geral

O que você precisa para começar

Adicionando seu primeiro script da API do Upcart

Comece a personalizar seu carrinho

Mais recursos