Autenticação
Como autenticar requisições na API de Pagamentos usando mTLS (certificado cliente)
Toda chamada à API de Pagamentos exige autenticação mútua via TLS (mTLS). A conexão só é estabelecida se o cliente apresentar um certificado digital válido, emitido e fornecido pela equipe da EagleIX. Requisições sem certificado, com certificado inválido, expirado ou não reconhecido pelo servidor são rejeitadas na camada de handshake TLS.
Certificado do cliente
O certificado cliente (chave privada + certificado, tipicamente em formato .pem,
.pfx/.p12 ou .crt/.key) é gerado e fornecido pela equipe da EagleIX durante
o onboarding da integração. Não há emissão self-service — solicite o material junto ao
time de Crédito. O certificado deve ser enviado em toda requisição à API.
| Item | Descrição |
|---|---|
| Certificado cliente | Emitido pela EagleIX, identifica o integrador de forma única |
| Chave privada | Fornecida junto ao certificado; nunca deve ser compartilhada ou versionada |
| CA raiz/intermediária | Fornecida pela EagleIX quando necessária para validar a cadeia |
URL base
| Ambiente | URL base |
|---|---|
| Sandbox | https://api.sandbox.eagleix.com.br |
Os caminhos dos endpoints nesta documentação são relativos à URL base. Exemplo:
POST /api/v1/payments corresponde a https://api.sandbox.eagleix.com.br/api/v1/payments.
Exemplo de requisição autenticada
curl -X POST https://api.sandbox.eagleix.com.br/api/v1/payments \
--cert cliente.crt \
--key cliente.key \
-H "Content-Type: application/json" \
-d '{ ... }'Nunca exponha o certificado ou a chave privada em repositórios de código, builds públicos ou logs. Trate-os como segredo e armazene em cofre/secret manager, com acesso restrito à camada responsável por estabelecer a conexão TLS.
Erros de autenticação
| Situação | Comportamento |
|---|---|
| Certificado ausente | Conexão TLS rejeitada no handshake |
| Certificado inválido, expirado ou não confiável | Conexão TLS rejeitada no handshake |