Como fazer integração com a API da BTG PACTUAL para geração de cobranças
Como integrar o BTG Pactual ao GDASH
Este guia mostra o passo a passo para conectar sua conta bancária do BTG Pactual à plataforma GDASH e começar a emitir cobranças.
Antes de começar
Certifique-se de que você tem:
- Acesso à sua conta BTG Pactual.
- Perfil de usuário na BTG Pactual com no mínimo o nível Operador
- Plano da empresa BTG a partir do plano Avançado
Passo 1 — Acesse as Integrações
No menu lateral do GDASH, clique em Integrações e depois em Gateways de Pagamento.

Passo 2 — Adicione uma nova integração
Selecione BTG Pactual na lista de gateways disponíveis, e clique em fazer login.

Passo 3 — Faça login no BTG Pactual
Você será redirecionado para a página de login do BTG Pactual. Entre com suas credenciais de acesso empresarial.

Passo 4 — Autorize o acesso
Após o login, o BTG Pactual exibirá uma tela pedindo autorização para que o GDASH acesse sua conta. Clique em Continuar.

Após isso, a BTG Pactual exibirá uma tela pedindo em qual empresa estará vinculado no GDASH. Clique em Confirmar.

Passo 5 — Retorne ao GDASH e selecione a conta bancária
Após autorizar o acesso, você será redirecionado de volta ao GDASH na aba de integrações. Para selecionar a conta bancária, abra novamente o modal do BTG Pactual (clique no gateway na lista de integrações).
O GDASH irá carregar as contas bancárias disponíveis na sua empresa junto ao BTG Pactual. Selecione a conta que deseja usar para emitir as cobranças e clique em Confirmar.

Dica: Caso sua empresa tenha mais de uma conta no BTG Pactual, escolha aquela que será usada para receber os pagamentos dos seus clientes.
Passo 6 — Confirme a integração
Clique em Confirmar para finalizar o cadastro. O GDASH irá salvar as informações da conta selecionada.

Passo 7 — Vincule o gateway à usina
Com a integração concluída, acesse a usina desejada no GDASH e vá até as configurações de cobrança. Selecione o BTG Pactual como gateway de pagamento ativo para aquela usina.

Passo 8 — Tudo pronto
O BTG Pactual agora aparece como integrado e as usinas vinculadas já estão aptas a emitir cobranças por boleto e PIX diretamente pelo GDASH.
Observação sobre custos: A emissão de boletos pelo BTG Pactual possui um custo por geração, assim como ocorre com outros gateways (Santander, Sicredi, etc.).
Dúvidas frequentes
A sessão de autorização expirou, o que faço?
O link de autorização do BTG Pactual tem validade de 5 minutos. Se expirar, basta reiniciar o processo a partir do Passo 2.
Posso trocar a conta bancária depois?
Sim. Delete a integração atual e refaça o processo selecionando a nova conta. Ou crie uma nova integração, e selecione na Usina qual conta bancária quiser.
É seguro autorizar o acesso?
Sim. O GDASH utiliza o protocolo OAuth 2.0, padrão de mercado para autorização segura. Suas senhas nunca são compartilhadas com o GDASH.
Atualizado em: 21/05/2026
Obrigado!
