Esta documentação descreve como conectar corretamente sua loja Linx Commerce à nossa plataforma, garantindo que produtos, carrinho e checkout funcionem de forma integrada.
📋 Requisitos
Antes de iniciar a integração, você precisará das seguintes informações:
- Domínio principal da sua loja (exemplo: https://seu-dominio.com.br)
- URLs base, de produtos e de checkout, conforme os padrões descritos abaixo.
Essas URLs são utilizadas para compor os endpoints de comunicação entre a loja Linx Commerce e a nossa plataforma.
🌐 Configuração das URLs
1. URL Base do Site
A URL base representa o endereço principal da sua loja — o domínio onde o cliente acessa o e-commerce.
Exemplo: https://seu-dominio.com.br
Essa URL será usada como referência para:
- Identificação da loja
- Exibição de páginas institucionais e conteúdo
- Acesso ao checkout
2. URL de Produtos Gerais
A URL de produtos é usada para acessar o catálogo disponibilizado pela Linx Commerce.
Ela segue sempre o mesmo padrão, substituindo apenas o domínio da sua loja: https://seu-dominio-sem-www.layer.core.dcg.com.br
- Importante: não inclua www no domínio.
Exemplos:
Essa URL será utilizada pela plataforma para buscar e sincronizar informações de produtos e estoques em tempo real.
3. URL de Checkout (Carrinho)
A URL de checkout representa o caminho onde o cliente conclui sua compra.
Geralmente, ela é uma rota do seu domínio principal.
Como por exemplo: https://seu-dominio.com.br/carrinho ou https://seu-dominio.com.br/checkout
Essa URL será usada para redirecionar o cliente ao finalizar o pedido na nossa plataforma.
Exemplo Prático de Configuração
Suponha que o domínio da sua loja seja:
A configuração correta seria:
⚙️ Recomendações Técnicas
Sempre utilize o protocolo HTTPS.
- Evite redirecionamentos automáticos entre www e sem www nas URLs de produtos.
- Verifique se o domínio .layer.core.dcg.com.br está ativo e acessível publicamente.
- Caso use múltiplos ambientes (produção e homologação), mantenha URLs distintas e documentadas.
- Após configurar, teste as URLs manualmente:
- A URL base deve carregar a loja.
- A URL de produtos deve retornar a página ou JSON de listagem de produtos.
- A URL de checkout deve abrir o carrinho funcional da loja.
