Ambientes

Produção é onde as coisas valem. Sandbox é uma cópia separada para testar sem consequência.

	Produção	Sandbox
URL base	`https://api.otlshoes.com.br/v1`	`https://api-sandbox.otlshoes.com.br/v1`
Prefixo do token	`otl_prod_`	`otl_sbx_`
Catálogo	O real	Espelho do real, atualizado a cada poucos minutos
Preço de atacado e estoque	Os reais	Os mesmos da produção
Pedidos, clientes, saldo	Reais	De teste — nada é atendido nem cobrado
E-mail e WhatsApp	Enviados	Nunca enviados
Quem cria o token	O parceiro, em Integrações	O parceiro, em Integrações → Ambiente de testes

São dois sistemas separados

O sandbox não é um “modo” da produção: é outra instalação, com outro banco de dados. Por isso:

um token só funciona no ambiente em que foi criado. Usar um token otl_sbx_ na URL de produção (ou o contrário) responde 401 TOKEN_DE_OUTRO_AMBIENTE. É o erro mais comum de quem sobe a integração para produção — troque a URL base e o token;
o que você cria no sandbox não existe na produção, e vice-versa;
os identificadores (id) são diferentes nos dois ambientes. O que é igual é o sku dos produtos.

O catálogo do sandbox

O sandbox recebe o catálogo da produção sozinho: produtos, preços, fotos, categorias e estoque. Uma mudança de preço ou de estoque leva alguns minutos para aparecer.

As fotos não são copiadas: os dois ambientes devolvem as mesmas URLs de imagem.

Simuladores

No sandbox ninguém da OTL confirma pagamento nem valida comprovante. Para testar o fluxo inteiro, você mesmo dispara essas ações pelos simuladores: status do pedido, validação de comprovante e de rastreio, lançamento no saldo e estoque de uma numeração. Eles só existem no sandbox.

Testar pela própria documentação

Toda página de referência tem, abaixo do exemplo, o painel Testar agora: você cola o seu token de teste, ajusta o caminho e o corpo, e a chamada é feita de verdade para a API de testes, direto do seu navegador.

Só funciona com o token de teste (otl_sbx_…). Token de produção é recusado pelo painel, e a API de produção não aceita chamadas vindas de uma página web.
O token fica só na aba aberta e some ao fechá-la. Mesmo assim, é uma credencial: não o cole num computador que não é seu.
Envio de arquivo (comprovante, banner, logo) não é feito pelo painel — use o curl do exemplo ou o Postman.

O painel de testes

O parceiro abre o painel de testes pelo botão Abrir painel de testes, na aba Integrações do painel oficial. Não há cadastro nem senha própria por padrão: a conta de testes é criada pela equipe OTL, e a entrada é sempre a partir do painel oficial.

Indo para a produção

Peça ao parceiro o token de produção.
Troque a URL base e o token na configuração do seu sistema — de preferência os dois vêm de variável de ambiente, nunca do código.
Chame o /v1/eu e confira "ambiente": "producao".
Refaça a carga inicial do catálogo: os id do sandbox não valem na produção.