Saltar para o conteúdo principal
O Therius roteia cada requisição para o ambiente de sandbox ou o de produção com base unicamente no prefixo da chave de API que você envia. Não há indicador de ambiente, nem opção de inicialização do SDK separada, nem arquivo de configuração para alterar. Quando estiver pronto para entrar no ar, você troca o prefixo da chave e atualiza a URL base — nada mais.

​
Sandbox

O ambiente de sandbox é um ambiente de teste totalmente isolado apoiado por um stub de provedor de teste. Nenhuma rede de cartões real está envolvida, nenhum dinheiro real se move e nenhuma conta real é cobrada. Use-o livremente durante o desenvolvimento e em pipelines de teste automatizado.

​
Cartões de teste do sandbox

Use qualquer data de validade futura, qualquer nome de titular e qualquer CVV de 3 dígitos (4 dígitos para Amex).

Referência completa de testes

Cada cartão de teste por rede, cenários de recusa por motivo, o passo a passo completo do 3D Secure e as respostas de APM no sandbox.

​
Produção

O ambiente de produção processa pagamentos reais sobre redes de cartões ao vivo. Cada cobrança é real, cada reembolso afeta contas reais e cada transação recusada é uma decisão real do emissor.

​
Sandbox vs. produção em resumo

​
Trocar de ambiente

Para passar do sandbox para a produção, faça duas mudanças na sua configuração:
  1. Substitua prv_sandbox_... por prv_production_... (e pub_sandbox_... por pub_production_...).
  2. Atualize a URL base de https://api-sandbox.therius.io/v1 para https://api.therius.io/v1.
Nenhuma outra mudança de código é necessária. Os mesmos corpos de requisição, as mesmas estruturas de resposta e os mesmos caminhos de endpoint funcionam nos dois ambientes.
Antes de trocar para a produção, verifique se toda requisição que altera dados no seu código envia um cabeçalho Idempotency-Key. No sandbox isso é opcional; em produção é obrigatório para evitar cobranças duplicadas nas novas tentativas de rede.

​
O cabeçalho X-Environment

As chamadas de API se autenticam com uma chave (ou, a partir do navegador, um clientToken de curta duração), e a credencial determina o ambiente: o prefixo da chave (prv_sandbox_ ou prv_production_) ou o ambiente para o qual o clientToken foi emitido. Isso inclui GET /payment/inquiry/{id}, que exige uma chave privada ou um clientToken e não aceita mais requisições sem autenticação.
Os valores válidos do cabeçalho X-Environment são sandbox e production, mas quando você inclui uma chave de API não precisa dele — o prefixo da chave tem precedência.