Passar para o conteúdo principal
Todas as coleçõesOperações Bancárias - PIX
Como receber por PIX pela API do Banco do Brasil?
Como receber por PIX pela API do Banco do Brasil?

Este artigo irá te auxiliar na ativação do PIX do Banco do Brasil para poder receber nessa modalidade.

Marilia Souza avatar
Escrito por Marilia Souza
Atualizado há mais de uma semana

O PIX é a solução de pagamentos e transferências instantâneas, criada e gerida pelo Banco Central. Este artigo vai te ajudar a gerar os QR Codes do PIX do Banco do Brasil e, assim, passar a receber nessa modalidade.

Para receber por Pix, você precisa ter uma conexão entre a Kobana e o Banco do Brasil criada na plataforma. confira o artigo e descubra como criar a conexão!

1. Crie a conta PIX

Caso ainda não tenha, você precisa criar uma conta PIX para associar à conexão com o banco. Acesse o menu Recebimentos > Pix > Contas Pix e clique para criar uma nova conta.

Cadastre os dados pedidos, dê um nome para essa conta (ex.: PIX - BANCO DO BRASIL - NOME DA EMPRESA), escolha a chave PIX e selecione a conexão com o Banco do Brasil.

2. Gere o PIX e boletos-híbridos

Ao finalizar os passos acima, você poderá começar a gerar o PIX e o boleto-híbrido.

Para gerar o boleto-híbrido, inclua a conta Pix em uma de suas carteiras de cobrança. Para fazer isso, acesse o menu Recebimentos > Boletos > Carteiras e clique em Ver Carteira (👁️) naquela que deseja configurar o boleto-híbrido.

Na próxima tela, clique em Ações > Alterar. No final da página de edição da carteira, você vai ver as informações sobre o boleto-híbrido e a opção de selecionar a conta do PIX. Selecione a conta PIX que desejar para esta carteira. Pronto! A partir de agora todos os boletos dessa carteira, serão gerados acompanhados de um QR Code do PIX.

Para gerar apenas o PIX, desacompanhado de um boleto, você deve consultar nossa documentação técnica.

O QR Code do PIX que geramos é dinâmico, ou seja, ele é gerado de acordo com valores e dados que você cadastrou no boleto. Porém, ele não obedece regras do boleto, como desconto, juros e multa. Quando utilizado em modelo boleto-híbrido, o PIX é baixado no vencimento do boleto.

Ativando os webhooks

Com o sucesso da conexão acima, a confirmação de pagamento dependerá de uma consulta da Kobana que acontece de hora em hora. Para que essas confirmações ocorram em tempo real, é necessário ativar os webhooks do banco. Para fazer isso, siga os passos abaixo:

1. Solicite a URL do webhook

Por meio do seu login, solicite em nosso chat na interface a URL correspondente ao webhook da sua conta PIX.

2. Acesse o Portal Developers do Banco do Brasil

Acesse o Portal Developers do Banco do Brasil com o seu login e senha: https://app.developers.bb.com.br/

Selecione a aplicação em produção que está conectada à Kobana.

Clique no sino no menu esquerdo que representa a parte de webhooks.

Clique no botão Cadastrar Novo Evento.

Como neste artigo estamos tratando da parte de PIX, agora você vai selecionar a API de PIX.

Caso tenha interesse em utilizar para boletos também, acesse este artigo: Como ativar a comunicação via API de recebimentos do Banco do Brasil?

Insira a chave PIX correspondente e cadastrada na Kobana para essa conta, inclua a URL disponibilizada pela nossa equipe para recebimento das notificações e o e-mail caso haja necessidade de um contato do banco.

Deixe o evento PIX Recebido selecionado e defina o status dele como Ativado. Clique em Salvar para finalizar.

Respondeu à sua pergunta?