Como criar uma aplicação
Crie sua aplicação, vincule CNPJs e produtos (APIs) e, se quiser, restrinja o acesso por IP.
Para criar uma aplicação, você precisa ter perfil Admin ou Owner.
O que é uma aplicação
Uma aplicação reúne os CNPJs e os produtos (APIs) que você vai usar na integração. O acesso usa credenciais e certificados.
Jornada de integração em 3 passos
Siga os passos na ordem. O passo 3 só é necessário se uma empresa parceira fizer a integração.
| Passo | Documentação | O que você faz |
|---|---|---|
| 1 | Como criar uma aplicação (esta página) | Dar nome à aplicação e vincular CNPJs, produtos (APIs) e, se quiser, IPs confiáveis. |
| 2 | Como criar credenciais e certificados | Gerar as credenciais por ambiente e emitir o certificado da aplicação. No momento, só existe o ambiente de Produção. |
| 3 | Como autorizar um integrador parceiro | Autorizar uma empresa parceira a integrar em nome da sua organização. |
Quem pode criar aplicações
Confira o que cada perfil faz no Itaú for Developers:
| Perfil | O que faz |
|---|---|
| Owner | Representa a empresa no Bankline (Internet Banking) PJ ou BBA. Configura os primeiros acessos, cria aplicações e aprova pedidos como a emissão de certificado e a autorização de integrador parceiro. Pode ser representante legal ou pessoa delegada. |
| Admin | Cuida da operação técnica no Itaú for Developers: cria aplicações, gera credenciais e pede certificados. |
| Developer | Tem acesso de leitura para consultar aplicações e as documentações dos produtos habilitados. Não cria aplicações. |
Aprovação do representante
O perfil Admin cria a aplicação e pede credenciais sem aprovação. O certificado e a autorização de um integrador parceiro precisam da aprovação de um representante no Bankline.
Criar uma nova aplicação
Acesse o portal
Depois de fazer login no Itaú for Developers, acesse a página Aplicações e credenciais, no menu do portal. Se você ainda está no portal anterior, selecione Conheça no banner Experimente a nova experiência do Itaú for Developers.
Selecione Criar nova aplicação
Na página Aplicações e credenciais, selecione o atalho Criar nova aplicação ou o botão Criar aplicação. A janela Criar nova aplicação abre na etapa Informações básicas.
Informe nome e descrição
Na etapa 1, Informações básicas, informe o nome da aplicação, de 4 a 80 caracteres, e, se quiser, uma descrição, de 4 a 200 caracteres. Depois, selecione Próximo.
Se algum campo não atender a esses limites, aparece uma mensagem de validação no próprio campo. Ajuste o texto para continuar.
Selecione os CNPJs
Na etapa 2, CNPJs da aplicação, marque os CNPJs que vão fazer parte da aplicação. Para encontrar um CNPJ, use a busca pelo número ou pela razão social; para marcar todos, use Selecionar todos os CNPJs. Depois, selecione Próximo.
CNPJ principal
O CNPJ principal (matriz) do grupo aparece marcado como obrigatório e faz parte de todas as aplicações.
Se a lista de CNPJs não carregar, aparece uma mensagem de erro. Selecione Tente novamente para recarregar a lista.
Selecione os produtos
Na etapa 3, Produtos da aplicação, marque os produtos (APIs) que a aplicação vai consumir. Para marcar todos de uma vez, use Selecionar todos os produtos. Depois, selecione Próximo.
Defina a restrição de IP (opcional)
Na etapa 4, Lista de IPs, defina quais endereços IP (Internet Protocol) podem acessar a aplicação. Escolha uma das opções:
- Permitir acesso de qualquer IP: a aplicação fica acessível de qualquer origem.
- Restringir a IPs confiáveis: só os endereços cadastrados acessam a aplicação. Informe cada endereço no campo Endereço de IP e selecione Adicionar IP. Cadastre pelo menos 1 IP confiável.
Para finalizar, selecione Criar aplicação na janela Criar nova aplicação.
Se a criação falhar
Entre em contato com o suporte Itaú.
Confira a aplicação criada
A aplicação criada aparece como um card na página Aplicações e credenciais, com status das credenciais (se houver), data de criação, empresa vinculada e produtos associados. Para ver mais opções, selecione Mostrar detalhes.
Página da aplicação
Para abrir a página da aplicação, selecione Mostrar detalhes no card da aplicação. Nela, você acessa a área de credenciais e certificados e a área de gestão dos CNPJs.
Depois da criação, você pode gerenciar os CNPJs, mas não os produtos. No momento, também não é possível editar a lista de IPs: essa funcionalidade está em desenvolvimento.
Próximos passos
- Com a aplicação criada, gere as credenciais por ambiente e emita o certificado: confira como em Como criar credenciais e certificados. No momento, só existe o ambiente de Produção; a geração de credenciais exclusivas de homologação está em desenvolvimento.
- Se uma empresa parceira fizer a integração, siga para Como autorizar um integrador parceiro.
Glossário
| Termo | Significado |
|---|---|
| Aplicação | Agrupamento de CNPJs e produtos (APIs) acessados por credenciais e certificados. |
| Credencial | Conjunto de Client ID e Client Secret usado para autenticar a aplicação. |
| Owner | Perfil que representa a empresa no Bankline, configura os primeiros acessos e aprova pedidos como a emissão de certificado e a autorização de integrador parceiro. Pode ser representante legal ou pessoa delegada. |
| Admin | Perfil que cuida da operação técnica no Itaú for Developers. |
| Developer | Perfil com acesso de leitura para consultar aplicações e documentações. |
| Integrador parceiro | Organização parceira autorizada a operar aplicações específicas da empresa. |
Perguntas frequentes
Preciso de aprovação para criar uma aplicação?
Não. Você cria a aplicação e pede credenciais sem aprovação. Só o certificado e a autorização de integrador parceiro precisam da aprovação de um representante no Bankline.
A restrição de IP é obrigatória?
Não. A etapa Lista de IPs é opcional: você pode permitir acesso de qualquer IP ou restringir a aplicação a IPs confiáveis.
Posso editar os produtos de uma aplicação depois?
Não. Depois da criação, não é possível editar os produtos da aplicação. Já os CNPJs você pode gerenciar na página da aplicação.
Posso remover o CNPJ principal?
Não. O CNPJ principal (matriz) do grupo sempre faz parte das aplicações.