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.

PassoDocumentaçãoO que você faz
1Como criar uma aplicação (esta página)Dar nome à aplicação e vincular CNPJs, produtos (APIs) e, se quiser, IPs confiáveis.
2Como criar credenciais e certificadosGerar as credenciais por ambiente e emitir o certificado da aplicação. No momento, só existe o ambiente de Produção.
3Como autorizar um integrador parceiroAutorizar 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:

PerfilO que faz
OwnerRepresenta 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.
AdminCuida da operação técnica no Itaú for Developers: cria aplicações, gera credenciais e pede certificados.
DeveloperTem 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.

Tela inicial do portal depois do login, com o banner Experimente a nova experiência do Itaú for Developers o botão Conheça e o catálogo de soluções

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.

Página Aplicações e credenciais com o atalho Criar nova aplicação, os cards das aplicações e o botão Criar aplicação

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.

Janela Criar nova aplicação na etapa 1 de 4, Informações básicas, com os campos Nome da aplicação e Descrição (opcional)

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.

Etapa 2 de 4, CNPJs da aplicação, com a busca por CNPJ ou Razão Social, a opção Selecionar todos os CNPJs e o CNPJ Principal marcado como obrigatório

Se a lista de CNPJs não carregar, aparece uma mensagem de erro. Selecione Tente novamente para recarregar a lista.

Mensagem de erro ao carregar os CNPJs com o botão Tente novamente

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.

Etapa 3 de 4, Produtos da aplicação, com um produto selecionado e a opção Selecionar todos os produtos

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.
Etapa 4 de 4, Lista de IPs (opcional), com a opção Permitir acesso de qualquer IP selecionada Etapa 4 de 4 com a opção Restringir a IPs confiáveis selecionada, o campo Endereço de IP, o botão Adicionar IP e a lista de IPs cadastrados

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.

Cards das aplicações criadas com a data de criação, os produtos e a opção 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.

Página da aplicação com os produtos habilitados, as credenciais recentes, os CNPJs vinculados e a lista de IPs fixos

Próximos passos

Glossário

TermoSignificado
AplicaçãoAgrupamento de CNPJs e produtos (APIs) acessados por credenciais e certificados.
CredencialConjunto de Client ID e Client Secret usado para autenticar a aplicação.
OwnerPerfil 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.
AdminPerfil que cuida da operação técnica no Itaú for Developers.
DeveloperPerfil com acesso de leitura para consultar aplicações e documentações.
Integrador parceiroOrganizaçã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.