Solicitando dados necessários

Para integrar sua aplicação com o Banco BTG Pactual e realizar emissões via Web Service (WS), siga os passos abaixo:

1. Criar uma Conta no BTG Pactual Empresas

Antes de tudo, é necessário possuir uma conta administradora ( corporativa ) no BTG Pactual Empresas. Essa conta será utilizada tanto para acessar o internet banking quanto para os processos de autenticação nas APIs.

2. Registrar um Usuário Desenvolvedor

Após criar sua conta, é importante registrar um usuário com perfil de desenvolvedor. Isso permitirá que você crie e gerencie aplicativos para interagir com as APIs do BTG. Para mais detalhes sobre como realizar esse registro, consulte o guia Registre um Usuário Desenvolvedor.​

3. Criar um Aplicativo

Com o usuário desenvolvedor registrado, o próximo passo é criar um aplicativo que consumirá as APIs do BTG Pactual Empresas.

• Primeiramente, será necessário preencher alguns dados da aplicação
  • Nome do aplicativo
  • Tipo: Confidencial
  • Descrição do aplicativo
  • URI's de redirecionamento: https://plugboleto.com.br/api/v1/email/callback
  • Modelo de integração: First party - Consumir recursos de contas próprias
• Escopos a serem utilizados
  • Selecione os escopos abaixo
    • Perfil do usuário
    • Consulta de Empresas
    • Banking: Saldo e extrato
    • Banking: Boleto cobrança
    • Gestão de Webhooks
  • Confira se os dados etão corretos

4. Obtendo as credenciais

Ao acessar o aplicativo, acesse o opção Chaves, lá estará disponível os dados para que possamos seguir para a próxima etapa.

5. Testar no Ambiente Sandbox

Antes de mover para o ambiente de produção, é recomendável testar sua integração no ambiente Sandbox fornecido pelo BTG Pactual. Esse ambiente permite simular operações e garantir que sua aplicação esteja funcionando conforme o esperado.

Para realizar os testes, acesse​ https://homologacao.plugboleto.com.br para que possa cadastrar sua conta e convênio.

Acessando o ambiente de testes, cadastre sua conta selecionando o banco BTG e em seguida preencha com seus dados bancários

Assim que for cadastrado, acesse o menu de convênios, preencha os dados obrigatórios e siga para a aba Configurações do convênio

Habilite o Registro instantâneo e preencha os dados abaixo

• OBS: o campo Código de autorização - BTG será preenchido com um token retornado executando o processo seguinte

Para ter acesso ao Código BTG, selecione o link Gerar código de autorização. O ambiente de desenvolvedor será disponibilizado para que possa seguir com a criação do código ( Lembre-se, uma conta desenvolvedora deve existir para que consiga acessar o ambiente ).

Acessando o ambiente, o escopos selecionados serão disponibilizados

Siga para selecionar o CNPJ de sua empresa ( Em Sandbox, será obrigatório escolher a opção BANCO BTG PACTUAL S.A.

Assim que seguir em frente, será redirecionado para a URL cadastrada anteriormente contendo o código para o cadastro em nossa API/

Assim que salvar o cadastro do convênio, siga para a emissão do boleto. Após validar sua integração no Sandbox, você pode proceder para o ambiente de produção.