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
- No menu da loja, abra Configurar > Apps e, no card Shopify, clique em Configurar.
- Na coluna App no Shopify Partners, copie a URL do app, a URL de redirecionamento e as Permissões (scopes).
- 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.
- Ainda no Partners, copie o Client ID e o Client Secret do app.
- De volta à Horsee, clique em Configurar Credenciais, cole os dois valores e clique em Salvar Credenciais.
- 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.
- 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