Navegação dos guias

Integração

Ambientes

Entenda as URLs disponíveis e qual ambiente utilizar em cada etapa da integração.

A Elix separa os ambientes de produção e homologação para manter operações reais isoladas dos testes internos. Cada ambiente possui URL e credenciais próprias.

1. Ambientes

No momento, clientes externos utilizam somente o ambiente de produção. A homologação existe para uso interno e ainda não possui acesso público.

1.1 Produção

Produção é o ambiente disponível para integrações externas. As operações são reais e podem gerar cobranças para seus clientes.

URL base
https://api.elixbank.com.br/api/v1

Operações reais

Valide payloads, valores e dados do pagador antes de enviar a requisição. Uma cobrança criada em produção não é uma simulação.

1.2 Homologação (staging)

A Elix possui uma estrutura interna de homologação, mas ela ainda não está disponível para usuários externos. Por isso, não publicamos uma URL base nem emitimos credenciais de teste.

Quando esse ambiente for disponibilizado, a mudança será anunciada nesta página. Até lá, não utilize domínios de staging encontrados em exemplos internos ou materiais antigos.

1.3 Credenciais por ambiente

Credenciais nunca são compartilhadas entre ambientes. As chaves geradas atualmente no Painel pertencem exclusivamente à produção.

  • Uma chave de produção autoriza somente chamadas em produção.
  • Não compartilhe o mesmo par de chaves entre aplicações ou serviços.
  • Identifique no gerenciador de segredos qual aplicação utiliza cada credencial.

2. Credenciais de produção

Gere o par de API Key e Secret Key na seção Credenciais API da Área do Cliente. O par criado já estará associado ao ambiente de produção.

Credenciais
API Key: SUA_API_KEYSecret Key: SUA_SECRET_KEY

A Secret Key completa é exibida somente no momento da criação. Armazene-a imediatamente em um gerenciador de segredos.

3. Credenciais de homologação

A Elix ainda não fornece credenciais de homologação para clientes externos. Não tente utilizar chaves de produção em URLs de teste.

Se sua integração exigir uma validação técnica específica antes da ativação, entre em contato com a equipe Elix.