Guia de instalação: documentação do CheckoutOS

Este guia apresenta instruções detalhadas de instalação do CheckoutOS. Siga as etapas para configurá-lo completamente na sua loja Shopify.

Antes de começar

O que você vai precisar

Acesso de administrador à loja Shopify
Cerca de 15–30 minutos para a configuração
Pelo menos um produto para testar

Etapa 1: instale o app do Chargezen

Acesse a Shopify App Store

Entre no administrador da Shopify e acesse Apps → Shopify App Store ou visite apps.shopify.com/chargezen diretamente.

Clique em "Add app"

Na página do app do Chargezen, clique em "Add app" para começar a instalação. Você será redirecionado para autorizar o app.

Autorize as permissões

Revise e aceite as permissões necessárias:

Products — Para exibir ofertas adicionais
Orders — Para acompanhar conversões e análises
Checkout — Para mostrar ofertas após a compra
Customers — Para recomendações personalizadas

Etapa 2: configure o CheckoutOS

Após a instalação, você será levado ao painel do Chargezen. Acesse CheckoutOS na barra lateral para iniciar a configuração.

Ative o CheckoutOS

Na página de visão geral do CheckoutOS, ative "Enable CheckoutOS" para habilitar o módulo. Isso ativa todos os recursos de otimização de checkout.

Configure os ajustes gerais

Defina suas preferências padrão:

Default discount type — Percentual ou valor fixo
Timer duration — Por quanto tempo as ofertas são exibidas (ou sem limite)
Branding — Combine com as cores e fontes da sua loja

Ative a página após a compra

Acesse Settings → Post-Purchase e clique em "Enable". No Shopify Plus, há integração com a extensibilidade do checkout. Nos demais planos, criamos uma página após a compra em conformidade com as regras.

Etapa 3: configuração do Shopify Plus (opcional)

Se você usa Shopify Plus, uma configuração adicional ativa os recursos nativos de checkout.

Somente Shopify Plus

Pule esta seção se não usa Shopify Plus. Os recursos abaixo exigem extensibilidade do checkout, exclusiva do Plus.

Ative a extensibilidade do checkout

No administrador da Shopify, acesse Settings → Checkout e confira se está usando a nova extensibilidade do checkout, não checkout.liquid.

Adicione a extensão do CheckoutOS

No painel do Chargezen, acesse CheckoutOS → Checkout Extensions e clique em "Install Extension". Isso adiciona nossos blocos ao checkout.

Configure a posição da extensão

Use o editor de checkout da Shopify para posicionar os elementos do CheckoutOS (selos de confiança, barras de progresso etc.) onde desejar no fluxo de checkout.

Etapa 4: teste a instalação

Antes de publicar, confira se tudo funciona corretamente:

Lista de testes

# Ative o modo de teste em Settings → Test Mode

1. Crie uma oferta adicional de teste
2. Faça um pedido de teste (use Bogus Gateway)
3. Conclua o checkout
4. Confira se a oferta adicional aparece
5. Aceite a oferta adicional
6. Confira se o pedido inclui o item adicional
7. Revise as análises no painel

Não pule os testes

Sempre teste com fluxos reais de checkout antes do lançamento. Isso identifica problemas de configuração e garante uma boa experiência para o cliente.

Solução de problemas

O app não instala — Confira se você tem acesso de administrador e tente limpar o cache do navegador.

As ofertas adicionais não aparecem — Confira se a oferta está publicada e se as regras de segmentação correspondem ao pedido de teste.

As extensões de checkout não aparecem — Confira se você usa Shopify Plus com a extensibilidade do checkout ativada.

Próximos passos

Crie sua primeira venda adicional

Saiba como criar e configurar ofertas adicionais

Saiba mais

Visão geral do painel

Conheça o painel do CheckoutOS

Saiba mais