Voltar para documentação
Integrações

Integração Cartpanda

Conecte sua loja Cartpanda ao Synchro Hub para receber vendas em tempo real e consolidar métricas no dashboard.

Visão geral

Ao integrar a Cartpanda, o Synchro Hub passa a:

  • Receber webhooks de pedidos, pagamentos, atualizações, reembolsos, chargebacks e upsells em tempo real (order.created, order.paid, order.updated, order.refunded, order.chargeback, order.upsell).
  • Acompanhar assinaturas (subscription.created, subscription.cancelled).
  • Consolidar cada pedido no dashboard com o valor correto, itens e status financeiro.

Tempo estimado: 5 minutos. O que você vai precisar:

  • Uma loja Cartpanda ativa, com acesso de administrador.
  • A API Token da sua loja e o Shop slug (identificador da loja).
  • Workspace já criado no Synchro Hub.

Importante: a integração é somente a partir de agora — pedidos anteriores à conexão não são importados.

Pré-requisitos

  • Estar logado no Synchro Hub com um workspace selecionado.
  • Ter acesso ao painel da Cartpanda em cartpanda.com.

Passo 1 — Obter a API Token e o Shop slug na Cartpanda

  1. Entre no painel da sua loja Cartpanda.
  2. Gere uma API Token nas configurações de API/integrações da loja e copie o valor.
  3. Anote o Shop slug — é o trecho que identifica a sua loja no endereço (a parte da URL do painel que corresponde ao nome da loja).

Guarde os dois valores — você vai colá-los no Passo 2.

Importante: a API Token dá ao Synchro Hub acesso de leitura aos seus pedidos. Guarde-a com segurança e não a compartilhe.

Passo 2 — Conectar a plataforma no Synchro Hub

  1. No Beacon, acesse Configurações → Integrações → Fontes de Venda.
  2. Clique em + Adicionar Plataforma.
  3. Selecione Cartpanda e clique em Confirmar.
  4. No card da Cartpanda, clique em Atualizar credenciais e preencha:
    • API Token
    • Shop slug
  5. Clique em Salvar.

O Synchro Hub valida as credenciais em tempo real conectando-se à Cartpanda. Se algo estiver errado, você verá uma mensagem de erro — nesse caso, confira os dois valores e tente novamente. Após salvar, o card passa a exibir Ativa / Conectado.

Passo 3 — Ativar o webhook (automático)

  1. No card da Cartpanda, clique em Configurar Webhook.
  2. Clique em Ativar Webhook.

O Synchro Hub registra automaticamente um único webhook cobrindo todos os eventos de venda — nenhuma configuração manual é necessária. Ao concluir, o card passa a exibir Webhook ativo.

Importante: se o registro automático falhar (por exemplo, token sem permissão), o Synchro Hub exibe a URL completa do webhook (já com o parâmetro ?token= de autenticação). Nesse caso, cadastre essa URL manualmente no painel da Cartpanda, em Webhooks, e mantenha-a exatamente como exibida.

Verificação

  1. Gere um pedido de teste na sua loja (uma compra real de valor baixo).
  2. Abra Vendas no menu lateral do Synchro Hub.
  3. A venda deve aparecer em até 1 minuto após o pagamento.

Limitações conhecidas

  • Somente a partir de agora: pedidos anteriores à conexão não são importados. Só valem os eventos recebidos a partir da ativação.
  • Multi-moeda: a Cartpanda opera em várias moedas (BRL, USD). O Synchro Hub registra o valor na moeda de origem, sem conversão. Se você vende fora do real, confira o valor no dashboard e abra ticket se notar divergência.

Solução de problemas

SintomaO que fazer
”Credenciais inválidas” ao salvarConfira a API Token e o Shop slug. O slug é o trecho que identifica a loja na URL do painel — sem espaços nem barras.
Falha ao ativar o webhookO Synchro Hub mostra a URL completa (com ?token=…) para cadastro manual no painel da Cartpanda em Webhooks. Cadastre-a exatamente como exibida.
Nenhuma venda chega após o pagamentoConfirme no card se está Webhook ativo e se a URL cadastrada na Cartpanda não foi removida/alterada.
Valor aparece diferente do esperadoConfira a moeda da venda no dashboard. Vendas em USD são registradas em dólar, sem conversão. Se destoar, abra ticket.

Perguntas frequentes

Tenho vários produtos na mesma loja. Preciso integrar cada um? Não. A integração é por loja. Todos os pedidos daquela loja passam a chegar pela mesma conexão.

A integração cobre assinaturas? Sim. Além das vendas avulsas, o Synchro Hub acompanha a criação e o cancelamento de assinaturas. As renovações chegam como novos pedidos pagos.

Posso reprocessar vendas antigas? Não automaticamente. A integração contabiliza vendas a partir da ativação.

Como desconecto a integração? No card da Cartpanda, clique em Remover. Para evitar tentativas de entrega sem destino, remova também o webhook do Synchro Hub no painel da Cartpanda, em Webhooks.