Chaves de Acesso
Para realizar as chamadas na API de Banking Gateway é preciso configurar suas chaves de acesso. Nós disponibilizamos dois tipos de chave secreta, uma para o ambiente de teste e outra para o ambiente de produção, como descritos na tabela abaixo:
| Ambiente | Tipo de chave | Quando usar |
|---|---|---|
| Teste | Chave privada, vinculada a sua aplicação na Plataforma Banking e disponibilizada no modo teste. ⚠️ As informações armazenados são dados sensíveis. Mantenha sua chave em sigilo e não a compartilhe com ninguém. | Disponibilizado para criação e implementação da integração. Nele, podem ser feitos testes para analisar o código e entender as funcionalidades a partir de transações que não processão recebíveis reais. |
| Produção | Chave privada, vinculada a sua aplicação na Plataforma Banking Gateway e e disponibilizada no modo de produção. ⚠️ As informações armazenados são dados sensíveis. Mantenha sua chave em sigilo e não a compartilhe com ninguém. | Este modo deve ser ativado quando o parceiro estiver pronto para lançar o produto e a homologação for aprovada. 📘 Neste ambiente são geradas transações com dados reais vinculados aos clientes. |
Ambas estão disponíveis na nossa plataforma de suporte e gerenciamento, consulte a guia Plataforma Banking para saber mais sobre ela. (link para a pág de plataforma na API).
Para acessar sua chave na Plataforma é necessário:
- Acessar a Plataforma
- Fazer o cadastro na Plataforma Banking
- Criar uma aplicação OU aceitar um convite de acesso.
- Consultar sua chave de API secreta.
Permissionamento de chaves
Dependendo da demanda do cliente as chaves disponibilizadas na Plataforma Banking podem ter permissões personalizadas, ou seja, acessar apenas alguns endpoints da API. Para saber mais
entre em contato com a nossa equipe de suporte.
Com a chave revelada, é necessário autenticar as chamadas realizadas na API de Banking Gateway, para isso deve-se:
- Acessar o Postman, por exemplo.
- Enviar um parâmetro
X-API-KEYno header das requisições da API de Banking Gateway. - Se os parâmetros enviados estiverem corretos vc receberá uma resposta de status
200 - ok
Agora, para completar as medidas de segurança obrigatórias da API de Banking Gateway, é necessário emitir um certificado mTLR para o ambiente de teste e outro para o ambiente de produção.
Updated 12 months ago