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.