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.

PassoDocumentaçãoO que você faz
1Como criar uma aplicaçãoNomeia a aplicação e vincula CNPJs, produtos (APIs) e, se quiser, IPs confiáveis.
2Como criar credenciais e certificadosGera as credenciais por ambiente e emite o certificado da aplicação.
3Como 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:

ParticipanteO que faz nesta jornada
AdminSeleciona as aplicações e o integrador parceiro e envia a solicitação de autorização.
OwnerAprova a autorização no Internet Banking, em Configuração de Integrações e APIs. É o representante legal da empresa ou uma pessoa Delegada.
Integrador parceiroDepois 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.

Menu Integradores parceiros e 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.

Página Integradores parceiros com o atalho Autorizar novo integrador, a tabela Suas autorizações e o botão Autorizar integrador

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.

Janela Autorizar novo integrador com o aviso Aprovação necessária e o campo Aplicações com a opção 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.

Campo Empresa integradora com a busca e a lista de integradores com os respectivos CNPJs

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.

Resumo da autorização com a confirmação dos Termos de Uso e Política de Privacidade e o botão 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.

Mensagem Solicitação enviada! com o botão Entendi

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çãoO que significa
Em aprovaçãoA solicitação foi enviada e aguarda a aprovação de um Owner.
AtivoA autorização foi aprovada e o integrador já acessa as aplicações.
Pedido expiradoA 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çãoOnde selecionarO que acontece
Editar autorizaçãoColuna Editar, na linha do integradorAbre o painel de edição para alterar as aplicações autorizadas para aquele integrador.
Excluir autorizaçãoColuna Excluir, na linha do integradorAbre uma janela de confirmação. A exclusão só acontece quando você seleciona Revogar.
Tabela Suas autorizações com as colunas Situação, Editar e Excluir Janela de confirmação da exclusão com o botão Revogar

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.

Janela de aviso exibida quando a empresa ainda não tem aplicações criadas

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

TermoSignificado
Integrador parceiroOrganização parceira autorizada a operar aplicações específicas da empresa.
AplicaçãoAgrupamento de CNPJs e produtos (APIs) acessados por credenciais e certificados.
CredencialClient ID e Client Secret usados para autenticação.
OwnerRepresenta 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.
AdminCuida da operação técnica no Itaú for Developers.
DeveloperTem acesso de leitura para consultar aplicações e documentações.
Aprovações sensíveisProcesso 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.