O PIX é a solução de pagamento instantâneo, criada e gerida pelo Banco Central do Brasil (BC), que proporciona a realização de transferências e de pagamentos. Este artigo irá te auxiliar na ativação para gerar os QR Codes do PIX do Itaú e, assim, passar a receber nessa modalidade.
Como conseguir as credenciais?
Observamos que o banco pode disponibilizar as credenciais do PIX de diferentes maneiras. Por isso, antes de qualquer outra ação, será preciso que você converse com seu gerente.
Explique ao mesmo que deseja gerar PIX de recebimentos por meio da API do banco e que a Kobana já possui a integração para isso, mas que seria necessário a disponibilização das credenciais: Client ID e Token Temporário.
A partir disso, o gerente poderá seguir os seguintes métodos:
1ª Hipótese - O banco enviará a você um token descriptografado, que você precisará anexar à Kobana (passo a passo logo a baixo). Você pode identificar essa condição caso o banco não tenha solicitado nenhuma comunicação para ter acesso a este token.
2ª Hipótese - Você já tem o token, pois alguém da sua equipe já enviou a chave ao banco e recebeu o token descriptografado.
3ª Hipótese - O banco vai pedir que você crie uma chave pública e envie a eles. Após o envio desta chave, disponibilizarão a você o token necessário para ativação.
4ª Hipótese - Em algum outro momento, você ou alguém de sua equipe já enviou uma chave pública ao banco para ativar a API, mas o processo não foi concluído. Neste caso, é preciso que você gere uma nova chave pública e envie ao banco. Ao encaminhá-la ao banco, especifique que você necessita que o token temporário seja gerado com a chave pública que você está enviando.
Quando devo gerar a chave pública?
Para cada hipótese levantada acima, há uma ação diferente que você deve executar:
1ª Hipótese - Como o banco já disponibilizou o token desciptografado, não há necessidade de gerar a chave pública. Neste caso, você poderá ir direto para a próxima seção deste artigo para saber como subir o token na Kobana.
2ª Hipótese - Como o banco já disponibilizou o token desciptografado, não há necessidade de gerar a chave pública. Neste caso, você poderá ir direto para a próxima seção deste artigo para saber como subir o token na Kobana.
3ª Hipótese - Você deverá seguir os passos logo abaixo para saber como gerar a chave pública na Kobana.
4ª Hipótese - Você deverá seguir os passos logo abaixo para saber como gerar a chave pública na Kobana.
Como gerar a chave pública?
Para que as credenciais do banco sejam disponibilizadas de forma segura, é preciso criar uma chave pública que será encaminhada ao banco. Você consegue fazer isso acessando o menu Integrações > Bancos e Serviços > API > Configurar Nova em sua conta da Kobana e selecionando o Banco Itaú.
Crie um nome para a conexão, como "PIX - ITAU - NOME DA EMPRESA". A seguir, você deverá selecionar opção para gerar a chave pública, uma vez que você se encaixa nas hipóteses 3 ou 4.
Na página seguinte, clique no ícone para fazer download da chave pública.
Com a chave pública baixada em seu computador, encaminhe a mesma ao gerente de cash, responsável pela integração da sua conta. No mesmo e-mail, solicite que ele encaminhe as credenciais criptografadas para integração via API de PIX.
Assim que o gerente disponibilizar as credenciais, siga para os passos abaixo.
Ativando o PIX na Kobana
1. Insira as credenciais na Kobana
Assim que o seu banco encaminhar as credenciais, de forma segura, copie as credenciais disponibilizadas, acesse o menu Integrações > Bancos e Serviços > API > Configurar Nova na sua conta da Kobana e selecione o logo do Banco Itaú. Dê um nome para essa conexão, como por exemplo: "PIX - ITAU - NOME DA EMPRESA", e insira as credencias para proceder com a ativação.
2. Crie sua conta PIX
Realizada a ativação da conexão, você deve agora criar um conta PIX. Para isso, acesse o menu Recebimentos > Pix > Contas PIX e cadastre essa nova conta. Selecione o banco Itaú, em seguida, selecione a conexão que você criou anteriormente e inclua a chave do PIX.
Prossiga com os demais procedimentos até que o sistema confirme que a conta PIX foi ativada com sucesso. Ao concluir este passo, os seus boletos ainda não estarão gerando o PIX no formato boleto híbrido.
3. Gere o PIX e boletos-híbridos
Ao finalizar os passos acima, você pode gerar o PIX e o boleto-híbrido incluindo a sua conta PIX em uma de suas carteiras de cobrança.
Para fazer isso acesse o menu Recebimentos > Boletos > Carteiras. 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ê visualizará informações sobre o boleto-híbrido e a opção de selecionar a conta geradora do PIX. Selecione a conta PIX que desejar para esta carteira. Pronto! A partir de agora, todos os boletos gerados nessa carteira serão acompanhados de um QR Code do PIX.
Atenção! 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.