Como autorizar um integrador parceiro
Passo a passo para autorizar uma empresa parceira a operar as suas aplicações, acompanhar a aprovação do Owner e gerenciar as autorizações concedidas
Aqui você encontra como selecionar as aplicações, escolher o integrador parceiro, solicitar a autorização e acompanhar a aprovação do Owner. Também mostramos como editar ou revogar autorizações já concedidas, para você manter o controle do acesso.
O que é um integrador parceiro
É uma organização parceira autorizada a operar aplicações específicas da sua empresa. Com a autorização aprovada, as pessoas desenvolvedoras do integrador acessam as aplicações selecionadas, consultam a documentação dos produtos e geram as próprias credenciais e certificados.
A nova experiência em 3 passos
A jornada de integração no novo portal está organizada em 3 documentações complementares. Esta é a última.
| Passo | Documentação | O que você faz |
|---|---|---|
| 1 | Como criar uma aplicação | Nomeia a aplicação e vincula CNPJs, produtos (APIs) e, se quiser, IPs confiáveis. |
| 2 | Como criar credenciais e certificados | Gera as credenciais por ambiente e emite o certificado da aplicação. |
| 3 | Como autorizar um integrador parceiro (esta página) | Autoriza uma empresa parceira a integrar em nome da sua organização. |
Quem participa
A autorização de um integrador parceiro envolve 3 participantes:
| Participante | O que faz nesta jornada |
|---|---|
| Admin | Seleciona as aplicações e o integrador parceiro e envia a solicitação de autorização. |
| Owner | Aprova a autorização no Internet Banking, em Configuração de Integrações e APIs. É o representante legal da empresa ou uma pessoa Delegada. |
| Integrador parceiro | Depois da aprovação, acessa as aplicações autorizadas e cria as próprias credenciais e certificados. |
Aprovação sensível
Como a autorização envolve dados e aplicações da sua empresa, ela só vale depois da aprovação de um Owner.
Etapas da jornada
A autorização acontece na página Integradores parceiros e tem 4 etapas.
Etapa 1: Iniciar a autorização
Acesse Integradores parceiros e selecione Autorizar novo integrador.
Etapa 2: Selecionar aplicações e integrador
Escolha as aplicações que o parceiro pode operar e a empresa integradora.
Etapa 3: Revisar e solicitar
Confira os detalhes, aceite os termos e envie a solicitação.
Etapa 4: Aguardar a aprovação do Owner
O Owner aprova no Internet Banking. Depois disso, o integrador acessa as aplicações.
Autorizar integrador parceiro
1. Acesse Integradores parceiros
No menu do portal, selecione Integradores parceiros. Se você estiver na página Aplicações e credenciais, também pode usar o atalho Convidar integrador parceiro.
2. Inicie a autorização
Na página Integradores parceiros, selecione o atalho Autorizar novo integrador ou o botão Autorizar integrador. A janela Autorizar novo integrador mostra em nome de qual empresa e CNPJ a autorização vai ser feita.
Para autorizar em nome de outra empresa, selecione Trocar vínculo ativo antes de iniciar.
3. Selecione as aplicações
No campo Aplicações, marque as aplicações que o integrador pode operar. A lista mostra todas as aplicações que você já criou. Para marcar todas de uma vez, use Selecionar tudo.
4. Selecione a empresa integradora
No campo Empresa integradora, digite o nome da empresa e selecione o integrador na lista, que mostra o nome e o CNPJ de cada empresa. Depois, selecione Continuar.
Lista de integradores
A lista mostra só integradores homologados, cadastrados pelo time do Itaú for Developers. Se o integrador que você procura não aparece, abra um chamado em Solicitar ajuda.
5. Revise e solicite a autorização
Confira os detalhes da autorização: empresa que concede a autorização, integradora autorizada e aplicações autorizadas. Se estiver tudo certo, marque a caixa de confirmação dos Termos de Uso e Política de Privacidade e selecione Solicitar autorização.
6. Aguarde a aprovação do Owner
Com a solicitação enviada, aparece a mensagem Solicitação enviada!. Selecione Entendi para voltar à página.

Enquanto o pedido está em análise, a autorização aparece em Suas autorizações com a situação Em aprovação e o integrador ainda não acessa as aplicações. O Owner, que pode ser o Representante Legal ou uma pessoa Delegada, aprova a solicitação no Internet Banking, em Configuração de Integrações e APIs.
7. Depois da aprovação
Com a aprovação, a autorização passa para a situação Ativo. As pessoas desenvolvedoras cadastradas no Itaú for Developers como membros da empresa integradora passam a acessar as aplicações autorizadas, consultar a documentação dos produtos e criar as próprias credenciais e certificados.
Gerenciar as autorizações concedidas
As autorizações ficam na tabela Suas autorizações, com a integradora autorizada, o CNPJ, a situação e o número de aplicações de cada uma.
| Situação | O que significa |
|---|---|
| Em aprovação | A solicitação foi enviada e aguarda a aprovação de um Owner. |
| Ativo | A autorização foi aprovada e o integrador já acessa as aplicações. |
| Pedido expirado | A solicitação não foi aprovada no prazo. Para autorizar o integrador, envie uma nova solicitação. |
Em cada linha da tabela, você pode:
| Ação | Onde selecionar | O que acontece |
|---|---|---|
| Editar autorização | Coluna Editar, na linha do integrador | Abre o painel de edição para alterar as aplicações autorizadas para aquele integrador. |
| Excluir autorização | Coluna Excluir, na linha do integrador | Abre uma janela de confirmação. A exclusão só acontece quando você seleciona Revogar. |
Revogar uma autorização
Depois de revogada, o integrador deixa de acessar as aplicações da autorização. Para dar acesso de novo, é preciso fazer uma nova autorização.
Autorização indisponível sem aplicação criada
Para autorizar um integrador parceiro, a empresa precisa ter pelo menos 1 aplicação criada. Sem aplicação, ao selecionar Integradores parceiros no menu, aparece uma janela que leva você para Aplicações e credenciais ou de volta para a página anterior.
Próximos passos
- Combine com o integrador quais aplicações ele vai operar e revise as autorizações com frequência.
- Avise o Owner da sua empresa sobre a solicitação, para que ele aprove no Internet Banking.
- Se ainda não criou aplicações, comece em Como criar uma aplicação.
- O integrador gera as próprias credenciais e certificados seguindo Como criar credenciais e certificados.
Glossário
| Termo | Significado |
|---|---|
| Integrador parceiro | Organização parceira autorizada a operar aplicações específicas da empresa. |
| Aplicação | Agrupamento de CNPJs e produtos (APIs) acessados por credenciais e certificados. |
| Credencial | Client ID e Client Secret usados para autenticação. |
| Owner | Representa a empresa no Internet Banking PJ/BBA, configura os primeiros acessos e aprova ações sensíveis. Pode ser o Representante Legal ou uma pessoa Delegada. |
| Admin | Cuida da operação técnica no Itaú for Developers. |
| Developer | Tem acesso de leitura para consultar aplicações e documentações. |
| Aprovações sensíveis | Processo de segurança em que uma solicitação do Admin precisa da aprovação do Owner. |
Perguntas frequentes
O que é um integrador parceiro?
É uma organização parceira autorizada a operar aplicações específicas da sua empresa. Essa autorização precisa da aprovação de um Owner.
A autorização precisa de aprovação?
Sim. Depois que o Admin envia a solicitação, um Owner aprova no Internet Banking, em Configuração de Integrações e APIs. Até lá, a autorização fica com a situação Em aprovação.
O que o integrador parceiro consegue fazer depois de autorizado?
As pessoas desenvolvedoras da empresa integradora acessam as aplicações autorizadas, consultam a documentação dos produtos e criam as próprias credenciais e certificados.
Posso autorizar mais de uma aplicação para o mesmo integrador?
Sim. No campo Aplicações, marque quantas quiser ou use Selecionar tudo.
Não encontro o integrador na lista. O que faço?
A lista mostra só integradores homologados, cadastrados pelo time do Itaú for Developers. Abra um chamado em Solicitar ajuda.
O que significa a situação Pedido expirado?
A solicitação não foi aprovada no prazo. Para autorizar o integrador, envie uma nova solicitação.
Como altero as aplicações autorizadas para um integrador?
Na tabela Suas autorizações, selecione Editar na linha do integrador e ajuste as aplicações.
Como revogo uma autorização?
Na tabela Suas autorizações, selecione Excluir na linha do integrador e confirme com Revogar.
Por que não consigo autorizar um integrador?
Porque a empresa ainda não tem aplicação criada. Crie pelo menos 1 aplicação antes de autorizar um integrador.