LinxCommerce

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:

https://linx-store.com.br

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.