> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.gdash.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como realizar a 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**.

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1ee8dth.png)

---

## Passo 2 — Adicione uma nova integração

Selecione **BTG Pactual** na lista de gateways disponíveis, e clique em fazer login.

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_tzbkva.png)

---

## 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.

![<!-- IMAGEM: tela de login do BTG Pactual -->](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_amhb1.png)

---

## 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**.

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1f45xhe.png)

Após isso, a BTG Pactual exibirá uma tela pedindo em qual empresa estará vinculado no GDASH. Clique em **Confirmar**.
![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1qhhojm.png)

---

## 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**.

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1vb9ni5.png)

> **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.

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_15sb98r.png)

---

## 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.


![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_9grh4v.png)

---

## 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.