Registrando um App

Veja como registrar um novo app para sua integração

Neste guia vamos utilizar o módulo de Gestão de Apps para criar um novo aplicativo BTG Pactual Empresas.

  1. Faça login na plataforma, clicando no botão entrar no menu superior.

  2. Acesse a funcionalidade de gestão de apps:

    • Meus Apps
      Você será levado a listagem de aplicativos, um lista com todos os aplicativos da sua conta será apresentada.
  3. Clique no botão "Novo".
    Você será levado ao formuário de criação de novo App.

  4. Nome: Defina um nome para sua aplicação. Este nome será apresentado ao usuário no momento do login.

  5. Tipo: O OAuth 2.0 define dois tipos de clientes, baseados na sua capacidade de manter suas credencias seguras:

    • Aplicativos Confidenciais geralmente são executados em um servidor e conseguem se autenticar no Authorization Server com o par de Client Id + Client Secret de forma segura.
    • Aplicativos Públicos geralmente são executados em ambiente não seguro, como por exemplo o Browser ou como um App nativo e não são capazes de armazenar o Client Secret, para esses casos outros meios de autenticação são utilizados.
  6. Redirect URIs: Endpoint utilizado para receber o callback do Authorization Server após o Login e Consentimento do usuário. Múltiplas urls de redirect podem ser utilizadas, separando-as por vírgula.

  7. Grant Types: Definem o fluxo utilizado para gerar o Access Token.

    • Selecione Authorization Code para aplicativos que precisam consumir APIs que precisam do Login e Consentimento do usuário.
    • Selecione Refresh Token caso deseje renovar os Acess Tokens utilizando refresh tokens após o Login e Consentimento do usuário.
    • Selecione Client Credentials para aplicativos que consomem apis expõem recursos que não pertence ao usuário(Resource Owner). O Fluxo Client Credentials permite que um Acess Token seja gerado com escopo de uso direto do Aplicativo.
  8. Scopes: Scopes definem o escopo de permissionamento do acesso token.

  9. Cliquem em Criar
    O novo app será criado, gerando um Client Id e um Client Secret.

  1. Após a criação do App, é necessário entrar em contato com a nossa equipe aqui para validação do mesmo, pois é necessário uma curadoria* sobre quais aplicativos estarão acessando as contas de clientes BTG.

*Procedimento não necessário em Sandbox.