Skip to main content
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

A maioria das chamadas de API se autentica com uma chave, e o prefixo da chave determina o ambiente. No entanto, alguns fluxos — como GET /payment/inquiry/{id} alcançado a partir do fluxo de retomada de pending_3ds — podem ser chamados sem chave. Nesses casos, passe o cabeçalho X-Environment para dizer ao Therius para qual ambiente rotear a requisição.
Os valores válidos são sandbox e production. Quando você inclui uma chave de API, não precisa deste cabeçalho — o prefixo da chave tem precedência.