Integrações
Conecta a loja aos serviços externos: quem processa o pagamento e quais ferramentas acompanham o comportamento do visitante.
Onde fica e quem acessa
Configuração → Integrações. Editar exige store.manage_integrations
sensível — é a permissão que dá acesso às credenciais de cobrança.
Gateways de pagamento
| Serviço | Processa | Uso principal | Disponível |
|---|---|---|---|
| Cielo | Pix e cartão de crédito | Cobrança na loja online. | sim |
| Stone | Cartão na maquininha e Pix | Maquininha Smart no balcão. | sim |
| Mercado Pago | Cartão e Pix na maquininha | Maquininha Point no balcão. | sim |
| Stripe | Cartão internacional | Pagamentos globais. | ainda não |
| PagBank | Pix, cartão e boleto | — | ainda não |
Ambiente: sandbox ou produção
Cada gateway tem um seletor de Ambiente com duas opções: Sandbox (testes) e Produção. Faça toda a validação em sandbox e só troque para produção quando o fluxo estiver fechado — em produção, cada teste é uma cobrança real.
Credenciais
Cada gateway pede as credenciais fornecidas pela própria operadora. Elas são informadas uma vez e ficam guardadas no servidor.
- Nunca envie chaves por chat, e-mail comum ou documento compartilhado.
- Conceda
store.manage_integrationsa pouquíssimas pessoas. - Se uma credencial vazar, gere uma nova no painel da operadora e substitua aqui.
Parcelamento
| Campo | Descrição | Exemplo |
|---|---|---|
| Máximo de parcelas | Até quantas vezes o cliente pode dividir. | 6 |
| Parcelas sem juros (até) | A partir daí, incide a taxa configurada. | 3 |
| Valor mínimo da parcela (R$) | Impede parcelas muito pequenas. | 0,00 |
| Taxa de juros (% ao mês) | Aplicada às parcelas além do limite sem juros. | 0,00 |
Parcelamento vale para cartão de crédito. Débito e Pix não parcelam.
Marketing e análise
| Ferramenta | Para que serve | O que você informa |
|---|---|---|
| Google Analytics 4 | Audiência e funil de compra, com eventos de e-commerce. | Measurement ID (formato G-XXXXXXX) |
| Meta Pixel | Conversões das campanhas de Facebook e Instagram. | Pixel ID (sequência numérica) |
| Google Ads | Conversão de compra para campanhas do Google. | Conversion ID (AW-123456789) e, opcionalmente, o Conversion Label |
| Hotjar | Mapas de calor e gravação de sessão. | Site ID |
| Microsoft Clarity | Mapas de calor e gravação de sessão, gratuito. | Project ID |
A empresa informa apenas o ID público da plataforma; a loja injeta o carregador correspondente a partir de uma origem fixa e conhecida. Não é possível colar um script arbitrário — é uma escolha deliberada de segurança.
Passo a passo: habilitar o pagamento
- Obtenha as credenciais no painel da operadora escolhida.
- Abra Integrações e selecione o gateway.
- Deixe o ambiente em Sandbox e informe as credenciais de teste.
- Configure o parcelamento.
- Faça uma compra de teste completa na loja, até receber o voucher.
- Troque para Produção e informe as credenciais reais.
- Faça uma compra real de valor baixo e, em seguida, estorne — validando os dois caminhos.
Erros comuns
| Sintoma | Causa provável | Solução |
|---|---|---|
| Pagamento não conclui | Credenciais incorretas ou ambiente trocado | Conferir credenciais e ambiente |
| Funciona em teste, falha em produção | Credenciais de sandbox ainda ativas | Trocar para as credenciais de produção |
| Parcelamento não aparece | Valor abaixo do mínimo por parcela | Revisar o valor mínimo configurado |
| Analytics sem dados | ID no formato errado ou integração desativada | Conferir o formato do ID e a chave de ativação |
| Não consigo abrir a tela | Falta store.manage_integrations | Solicitar a permissão |