Ambientes

Use os ambientes para diferenciar testes e produção.

📘

Isolamento de Ambientes

Nossa infraestrutura opera com ambientes estritamente isolados. Não há qualquer interação ou compartilhamento de dados entre as camadas de Homologação e Produção.


Homologação (Sandbox)

O ambiente de homologação é destinado à validação técnica e funcional. Nele, as transações não utilizam valores reais, permitindo o teste completo de fluxos, webhooks e integrações sem riscos financeiros.

  • Acesso: Solicite as credenciais de teste ao time comercial. Informe quais produtos e serviços serão integrados para a configuração correta do seu perfil.
  • Endpoints: As URLs de homologação utilizam o prefixo -h:
    • api-h.qesh.ai
    • iam-h.qesh.ai
  • Rate Limit: Por ser um ambiente compartilhado para testes, o limite é de 20 requisições por minuto (20 req/min) por cliente.

Produção (Live)

Este é o ambiente transacional onde as operações têm efeito real, envolvendo movimentação de valores, emissão de documentos e notificações oficiais.

  • Acesso e Ativação: Para migrar para produção, é obrigatória a validação do processo homologatório. O time comercial fornecerá um formulário de testes que deve ser preenchido com as evidências do histórico de uso em homologação.
  • Homologação por Serviço: A liberação é específica para o produto contratado:
    • Connect (Pix Avulso): Exige validação de fluxos de envio e recebimento.
    • Axis (Split de Pagamento): Exige validação de fluxos de pagamento, distribuição de valores e liquidação final.
  • Endpoints: As requisições de produção utilizam os domínios principais:
    • api.qesh.ai
    • iam.qesh.ai

💡 Nota de Suporte: O preenchimento do formulário permite que nosso time de suporte garanta que sua integração está resiliente e pronta para operar com segurança no mercado.