> For the complete documentation index, see [llms.txt](https://ajudaerp.sfhera.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajudaerp.sfhera.com.br/integracoes/shipay/pix-banco-do-brasil.md).

# Pix Banco do Brasil

Agora você pode integrar também o Pix do Banco do Brasil na Shipay e receber por Pix diretamente em seu caixa. Veja só o passo a passo abaixo para saber como conseguir as credenciais de integração e enviá-las para a Shipay!

Dividiremos esse artigo em duas partes. A primeira será a parte CADASTRAL e a segunda será a parte de IMPLANTAÇÃO.

1\. Primeiro acesse o site: <https://developers.bb.com.br/home>&#x20;

2\. Clique em "Cadastre-se" no canto superior direito, conforme a imagem a seguir:

\
![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002800/original/o2ADhRBBR6p-wm0mgcUAXxv5OP1p_W9q9g.png?1711642784)

3\. Será solicitado o cadastro a partir de seu CPF. Caso o cadastro já tenha sido efetuado e você não se recorde de sua senha, clique em LOGIN e depois em "Esqueceu?" e prossiga conforme as orientações em tela.

Atenção: só é possível um cadastro por CPF.

![mceclip2.png](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002780/original/zonBMcCgpzQVLXffP9hWhNsRQGrHDSEb5g.png?1711642777)

4\. A tela seguinte solicitará o nome completo, nome da mãe e data de nascimento:

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002747/original/C9MbZF1CfJ2v7AAUPb6zbJLBgPo0So-ijQ.png?1711642766)

5\. Em seguida, será solicitado e-mail e celular, será enviado um SMS no celular para confirmar o cadastro:

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002770/original/ubDmHFS80Qsods4yyx5WvAnOc2TK0p0Arg.png?1711642775)

![mceclip3.png](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002781/original/EOR4ANPoLcWM0sDBxFSxL1eLfCwTuJZp1Q.png?1711642778)![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002765/original/nuDtPtQg9hL6ngpHyM2SHcdsYtG3kSmAdg.png?1711642772)

6\. Na sequência, você precisará criar uma senha de acesso:

![mceclip6.png](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002792/original/5tB7mxtSANc60k-9XcOMEkF4r2cqojb1Qg.png?1711642783)

Após definir a senha você verá a seguinte tela:

![mceclip7.png](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002746/original/Ql1XHmtd_A6gFVu2W7nlGLtYg5KJbpE30A.png?1711642764)

7\. Uma vez criada a senha, o usuário deverá retornar à [tela principal](https://developers.bb.com.br/home) e clicar em LOGIN no canto superior direito da tela, fornecer CPF e senha para efetuar o login no Portal:

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002799/original/RpiLtPAvqmsnoyXVJWc2q9xOTRLsxBAM-Q.png?1711642784)

8\. Caso seja o primeiro acesso, será exibido o Termo de Uso da Plataforma DeveX Banco do Brasil. É necessário rolar até o final do documento para que o botão de assinatura seja habilitado.

![mceclip9.png](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002787/original/3p-RwJt0uhFsj8iecVjdtqBrjkfm_ABcEQ.png?1711642781)

**Atenção**: este termo NÃO É O TERMO DA API DE COBRANÇA, é apenas um termo de utilização do Portal. Portanto, a assinatura dele é obrigatória para todos os usuários do Portal e não substitui a necessidade de assinatura do Termo da API quando forem solicitadas as credenciais de produção.&#x20;

Essa foi a parte do CADASTRAMENTO, vamos iniciar o processo de IMPLANTAÇÃO agora.

| Processo de Implantação da API |
| ------------------------------ |

1\. Uma vez dentro do Portal, você deverá clicar no link “Criar Nova Aplicação” conforme o exemplo abaixo:

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002797/original/ziKoXp1ljAGzUl8bJsOj_3xpdbA6n8m5sQ.png?1711642783)

Será aberta uma tela para cadastro da aplicação e você preencherá os dados e criará a aplicação.

ATENÇÃO: Orientações para preenchimento dos campos:

* Nome da Aplicação: com 20 caracteres. Critério livre.

Ex. Aplicação de Teste 1

* Descrição: com 200 caracteres. Critério livre.

Ex. Aplicação nº 01 para teste do piloto

* URL do Ícone: (não obrigatório).

Ex. <https://logoteste.com.br>

* URI de Callback: este campo poderá ter um valor fictício. Insira o exemplo abaixo.

Ex. [https://callbackteste.com.br](https://callbackteste.com.br/)

&#x20;Exemplo:

![mceclip0.png](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002785/original/6-UWVPYo163WRiX2gf-QVGJN9Rz5DOiY4A.png?1711642780)

Selecione a coluna do meio "Pix":

![mceclip0.png](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002793/original/vKI29qDjxj8zCZuZXRShTzeJu6Ze0IKlzA.png?1711642782)

2\. Uma vez criada a aplicação, você deverá clicar sobre a mesma:

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002783/original/okUpcTBgGl3mT0r3ShB15IfRWX3KVywDnA.png?1711642779)

A seguinte tela será apresentada:

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002786/original/EQBZufSIGwnWdjea9EvyX6NbvWlVDQRYKw.png?1711642780)

3\. Dentro da aplicação, será exibida uma barra lateral, à esquerda. O 5º ícone, de cima para baixo, corresponde à área de credenciais. As de homologação (teste) serão automaticamente geradas.

![mceclip14.png](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002782/original/5wEHsBnPR7LZVCpmbRcPoJ_DqZjssSKehg.png?1711642778)

Lembramos que, atualmente, todos os dados de TESTE são fictícios.&#x20;

As orientações sobre como proceder para conseguir realizar chamadas, bem como o Swagger, estão no Portal, conforme abaixo (item APIs da Barra à esquerda):

![mceclip15.png](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002796/original/nIbFKkWwZdqwXnxkjKGH5nX3TQ81lxyj_A.png?1711642783)

Caso ocorra alguma dúvida ao longo do processo, você poderá:

* Consultar / enviar mensagens pelo FÓRUM (no canto superior direito do cabeçalho azul, terceiro ícone da direita para a esquerda).
* Consultar a FAQ (no canto superior direito, primeiro ícone da direita, clicar para abrir o menu lateral. A FAQ é o terceiro item de cima para baixo).
* Nos enviar uma mensagem por meio de nossos Canais de Atendimento.

![mceclip17.png](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002795/original/nuoUTy0auS37RkirMrt_W8zSUbSpiysrhQ.png?1711642783)

4\. Ao entender que os testes foram suficientes, você deverá submeter à PRODUÇÃO a aplicação criada.

Para isso, será necessário:

* Clicar no item "Produção" na barra lateral (4º item de cima para baixo)
* Fornecer o CNPJ da empresa que utilizará a solução (com convênio de cobrança) e mandar PESQUISAR
* O nome da empresa aparecerá na tela abaixo para confirmação.
* Clicar em "Próximo" e submeter.

&#x20;5\. A sequência de procedimentos do item acima irá submeter a aplicação para a produção.

Caso você não seja também outorgado da empresa convenente:

* Irá gerar uma pendência ao outorgado da empresa, que será visualizada no ícone de “SININHO” (segundo ícone da esquerda para direita, no cabeçalho superior). Neste caso, o outorgado precisará logar no portal, clicar no “SININHO” e assinar o Termo de Adesão da API que excluirá a pendência.

Caso você seja outorgado da empresa convenente:

Você mesmo assinará o Termo de Adesão. Após a assinatura do Termo de Adesão, as credenciais de Produção estarão disponíveis na Aplicação.

![mceclip15.png](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002790/original/6NWz75_ShhGyyxDqOzVh7rhmm8w5f0z_nQ.png?1711642782)

6\. Quando a aplicação estiver em produção, será possível consultar as credenciais inerentes a esse ambiente na área de CREDENCIAIS.

![mceclip16.png](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002794/original/96nbyrGIR-zzdNFrQjW4IoY5-rMTil1CKg.png?1711642783)

7\. Após isso faz necessário consultar o certificado para a validação na API.

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002798/original/b3wW9hBjI9uT4orhjI-Oj8UE9QBzJws8HQ.jpeg?1711642783)

9\. Basta enviar o certificado em questão:

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002789/original/UwcX6z161q4IWVvkhFxwV9y0DibjJO6RTA.png?1711642782)

\
Integrando as chaves no Painel Shipay:&#x20;

ATENÇÃO: Fique a vontade para inserir as credenciais em sua loja no Painel Shipay, mas lembre-se de remover pontos, traços e barra do seu CNPJ caso ele seja sua chave Pix.

Veja os detalhes abaixo:

* Acesse seu [Painel Shipay](https://painelv2.shipay.com.br/), clique em Pix e depois no ícone do Banco do Brasil

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002791/original/HY2pEYVE8HW1erwC3jrParOAbgYl2Czwsg.png?1711642782)

* Ao clicar no ícone, a seguinte janela será aberta e preencha ela de tal modo: ⁣![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/154011002784/original/ILAvDQMfuSXc3g1dJwQ1r3pVaLlCwFe8Lg.png?1711642780)<br>
* Clique em cadastrar, abra sua Loja (clicando no menu lateral esquerdo) e associe a carteira Pix do BB em suas Lojas e Caixas. Veja como fazer isso no artigo [Manual Painel Shipay](https://shipaysupport.zendesk.com/hc/pt-br/articles/1500003358002-Manual-do-painel-Shipay). \
  Por fim, se restar alguma dúvida, basta verificar o tutorial em vídeo: <https://www.youtube.com/channel/UCeFnX97ziC3dF3tUAt8U9QA>

**ATENÇÃO**: NÃO é possível receber transações caso Exclua/Desative a chave Pix do Painel Shipay
