[BR] Lembrete sobre Ambiente Sandbox (Sandbox Testing V2)

Olá, desenvolvedores

O Sandbox é o ambiente de testes da Shopee Open Platform, utilizado por desenvolvedores para validar integrações antes de ir para produção. Ele fornece:

1. Contas de teste (shop/merchant);

2. Criação de pedidos de teste;

3. Simulação básica de fluxos principais (produto, pedido, logística).

Embora funcional, o Sandbox não replica 100% o comportamento do ambiente real.

- Pedidos de teste precisam de tempo para processamento (ex: alguns minutos entre etapas);

- Fluxos como envio (shipment), pickup e delivery são simulados manualmente;

- Não realizamos nenhum tipo de liberação no Ambiente Sandbox, ele é pré-construído.

E, portanto, podem ocorrer intermitências no ambiente Sandbox (test-stable), como:

- Erros na criação de pedidos de teste ("error_sandbox_order_checkout_cart_item"; "invalid product, please use another product and try again later.");

- Falhas em chamadas de API ("Failed to get info, please try again later.");

- Comportamentos inconsistentes durante testes.

- O erro “Wrong Sign” (assinatura incorreta) geralmente indica um problema com a validação da assinatura durante as chamadas da API. De acordo com a documentação oficial, aqui estão os motivos comuns e as etapas de solução de problemas:

• Consistência do ambiente: Certifique-se de que o ambiente associado ao seu ID de parceiro e à sua chave de parceiro corresponda ao ambiente da API que está sendo chamada. * Consistência do carimbo de data/hora: Certifique-se de que o carimbo de data/hora usado para gerar a assinatura corresponda ao carimbo de data/hora incluído na URL de consulta da chamada da API. * Precisão da string base: Verifique se a string base usada para a assinatura foi construída corretamente, de acordo com as especificações fornecidas pela Shopee.

Verifique novamente todas informações e parâmetros exigidos diretamente em "Calculating the sign parameter" (Calculando o parâmetro de assinatura).

Nosso time de engenharia trabalha internamente para normalizar o ambiente sempre que possível, recomendamos:

1. Tentar novamente a operação após alguns minutos;

2. Evitar múltiplas execuções seguidas;

3. Criar novos itens/pedidos para novos testes;

4. Respeitar intervalos entre ações;

Em caso de erros persistêntes,

5. Realizar o Go Live do app;

6. Testar diretamente em produção com boas práticas:

- Uso de dados controlados;

- Escopo mínimo necessário;

- Monitoramento das chamadas;

- Não criar orders várias vezes seguidas;

- Não utilizar mesmo dispositivo para criação de orders;

- Utilizar aba anônima.

Importante:

Também não há liberação manual para produção (Go Live), portanto não é necessário abertura de ticket. O Go Live é automático do sistema e pode levar até 48 horas.

As informações completas sobre o Ambiente Sandbox estão em nossa documentação: Sandbox Testing V2.

Para realizar o fluxo de Autorização de Lojas para liberar os Tokens, refira-se a nossa documentação Authorization and Authentication.

Agradecemos,

Shopee Open Platform