Cada ambiente tem seu contexto
Configure a base da API, a chave e o receptor de webhooks como um conjunto. Uma transação pertence ao Tenant e ambiente resolvidos pela credencial. Um identificador válido em outro ambiente não concede acesso e pode resultar em 404.
KYC_API_BASE_URL=https://api.example.invalid
KYC_API_KEY=REPLACE_ON_YOUR_SERVER
KYC_WEBHOOK_SECRET=REPLACE_ON_YOUR_SERVEREsses valores são placeholders. Não copie endereços de exemplos como se comprovassem um ambiente ativo. Confirme os endereços e acessos oficiais durante a habilitação da sua integração.
Separe também o seu sistema
Use configurações independentes para banco de dados, filas e callbacks. Inclua o ambiente na chave de associação local da transação. Uma rotina de teste nunca deve ativar crédito, liberar uma conta ou alterar contratos reais.
Utilize dados sintéticos nos testes de contrato. Quando a homologação exigir uma jornada real, combine finalidade, acesso e tratamento dos dados com os responsáveis pela operação. Não envie documentos pessoais ao simulador público: ele trabalha apenas com cenários fixos no navegador.
Antes da mudança de ambiente
Confirme credenciais, permissões de download, configuração de callback, segredo HMAC e regras de continuidade. Verifique também quais IPs e URLs são autorizados. Reexecute seus testes de rejeição, expiração e reconciliação; uma conexão bem-sucedida não substitui a validação funcional. Consulte o checklist de produção.