Integrações

Integração Shopify

Atualizado em 03/11/2026

Use o Shopify como destino dos pedidos e para captura de pagamento via Shopify Payments.

Para que serve

A integração Shopify faz o checkout da sua loja Horsee cobrar pelo checkout da Shopify: cada compra vira um pedido na sua conta Shopify, o cliente paga lá com o Shopify Payments e o pedido pago volta para a Horsee. O catálogo continua sendo gerenciado na Horsee; o Shopify recebe os pedidos e processa o pagamento.

Antes de começar

  • Uma loja Shopify com o Shopify Payments ativo.
  • Um domínio próprio conectado e verificado na sua loja Horsee (veja como configurar o domínio). Sem ele, a janela avisa: "Para conectar a Shopify, sua loja precisa de um domínio próprio conectado e verificado."
  • Uma conta no Shopify Partners (é gratuita), onde você cria o app que liga as duas lojas. Não precisa ser programador.

Passo a passo

  1. No menu da loja, abra Configurar > Apps e, no card Shopify, clique em Configurar.
  2. Na coluna App no Shopify Partners, copie a URL do app, a URL de redirecionamento e as Permissões (scopes).
  3. No Shopify Partners, vá em Apps > Criar app, dê um nome que você reconheça e cole esses valores nos campos de URLs e de scopes da API Admin. Eles precisam bater exatamente, inclusive maiúsculas e vírgulas.
  4. Ainda no Partners, copie o Client ID e o Client Secret do app.
  5. De volta à Horsee, clique em Configurar Credenciais, cole os dois valores e clique em Salvar Credenciais.
  6. Em Adicionar Nova Conta Shopify, informe o Domínio da Loja (ex.: minha-loja ou minha-loja.myshopify.com) e clique em Conectar com Shopify.
  7. Autorize o acesso na Shopify. Ao voltar, a conta aparece em Contas Shopify. Clique em Testar para conferir a conexão.

Os webhooks de pedidos pagos, reembolsos, chargebacks e desinstalação do app são registrados sozinhos no domínio da sua loja.

O que a integração faz

  • Envio de pedidos: o checkout cria o pedido na Shopify e leva o cliente ao pagamento de lá. O pedido vai para a conta ativa de maior prioridade.
  • Checkout via Shopify Payments: a cobrança é capturada pela sua conta Shopify, e o pedido pago volta para a Horsee pelo webhook de pedidos pagos.
  • Várias contas: arraste as contas para mudar a prioridade; contas com peso de distribuição dividem os checkouts na proporção do peso.
  • Produtos reais na Shopify: com a opção "Só usar Shopify quando todos os produtos existirem na Shopify" ligada, o pedido usa o produto cadastrado lá, casado pelo SKU. Clique em Verificar SKUs para ver o que falta. Se algum item não existir, o checkout segue para o próximo meio de pagamento.
  • Verificação de saúde (health check): o card mostra a data do último health check, as falhas consecutivas e o status da conexão e da conta de pagamentos.

Erros comuns

  • "Shopify conectado, mas webhooks falharam": os pedidos pagos não voltam para a Horsee. Expanda a conta e clique em Re-registrar webhooks.
  • "Scopes insuficientes": expanda a conta e clique em Atualizar Scopes.
  • "Assinatura de segurança inválida" ou "Falha ao obter token de acesso": confira se o Client ID, o Client Secret, as URLs e os scopes no Partners são idênticos aos da janela.
  • "Esta loja Shopify já está conectada a outra loja Horsee": desconecte de lá antes de conectar aqui.
  • "Publique a loja novamente para ativar a conexão com a Shopify": clique em Publicar agora e reabra a janela quando a publicação terminar.
  • Status "Expirado": a conexão usa OAuth 2.0 e pode expirar. Clique em Reconectar.
Importante: a integração não sincroniza catálogo nem estoque de forma automática. Os produtos são gerenciados na Horsee; o Shopify atua como destino de pedidos e captura de pagamento.

Este artigo foi útil?

Ajude-nos a melhorar nosso conteúdo com seu feedback