Rotas que a borda pública responde

Esta seção documenta, por fora da referência de cada serviço, o que é comum a toda chamada que passa pela borda pública da Vellus Payments: o que o gateway responde antes mesmo de chegar ao serviço, e o que nunca chega a ser roteado.

Health check não é um endpoint de integração

Nenhum serviço expõe verificação de saúde (health/ready) como parte da sua API pública. Esses caminhos existem só para monitoramento de disponibilidade operado pela Vellus Payments, nunca como um endpoint documentado para quem integra. Uma chamada a um caminho desse tipo recebe 404 (rota inexistente) ou 403, dependendo do serviço. Se a aplicação integradora precisa saber se um serviço está disponível, o caminho correto é o comportamento de erro documentado em cada endpoint de negócio (timeout, 5xx, retry com backoff), não um health check.

O cabeçalho de correlação é sempre propagado

Toda resposta da borda pública inclui o cabeçalho x-correlation-id. Se a chamada já enviar esse cabeçalho, o valor é preservado; se não enviar, um valor é gerado e devolvido na resposta. Guardar esse valor por chamada é a forma recomendada de referenciar uma requisição específica num pedido de suporte, porque ele identifica a chamada de ponta a ponta nos sistemas da Vellus Payments, mesmo que a resposta não traga detalhe suficiente para diagnosticar o problema por conta própria.

A trilha de auditoria não é pública

A trilha de auditoria de uma conta não é exposta por nenhuma rota da API pública. Quem integra não tem, e não deve esperar ter, uma forma de consultar diretamente o histórico de eventos auditados de um recurso; essa trilha é de uso interno da Vellus Payments.