{"id":2084,"date":"2021-04-20T08:43:53","date_gmt":"2021-04-20T11:43:53","guid":{"rendered":"http:\/\/www.l2maker.com.br\/documentacao\/?p=2084"},"modified":"2024-11-05T08:45:31","modified_gmt":"2024-11-05T11:45:31","slug":"trabalhando-com-o-pix-no-banco-do-brasil-bb-001","status":"publish","type":"post","link":"https:\/\/www.l2maker.com.br\/documentacao\/2021\/04\/trabalhando-com-o-pix-no-banco-do-brasil-bb-001\/","title":{"rendered":"Trabalhando com o PIX no Banco do Brasil (BB \/ 001)"},"content":{"rendered":"\n<p><strong>IMPORTANTE<\/strong>: Os passos aqui descritos s\u00e3o mera complementa\u00e7\u00e3o e\/ou resumo da documenta\u00e7\u00e3o oficial do BB. Sigam sempre as instru\u00e7\u00e3o oficiais passadas pelo banco. Nem todas as informa\u00e7\u00f5es aqui contidas podem estar atualizadas (\u00faltima revis\u00e3o 06\/09\/2023).<\/p>\n\n\n\n<p><strong>NOTA<\/strong>: O suporte da API n\u00e3o cobre o uso\/cadastro\/coleta de informa\u00e7\u00f5es junto ao banco.<\/p>\n\n\n\n<p><br>A inicializa\u00e7\u00e3o do PIX com o BB deve seguir os seguintes passos:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Crie uma conta no portal de desenvolvedores do BB: <a rel=\"noreferrer noopener\" href=\"https:\/\/app.developers.bb.com.br\/#\/login\" target=\"_blank\">https:\/\/app.developers.bb.com.br\/#\/login<\/a><\/li>\n\n\n\n<li>Crie uma nova aplica\u00e7\u00e3o, e ative as APIs de <strong>Cobran\u00e7a <\/strong>e <strong>PIX<\/strong>:\n<ol class=\"wp-block-list\">\n<li>O &#8220;URI de Callback&#8221; e \u00cdcone podem ficar em branco;<\/li>\n<\/ol>\n<\/li>\n\n\n\n<li>Selecione a aplica\u00e7\u00e3o e no item do menu &#8220;Credenciais&#8221; ( <a href=\"https:\/\/app.developers.bb.com.br\/#\/menu\/credenciais\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/app.developers.bb.com.br\/#\/menu\/credenciais<\/a> ) consulte os dados de acesso: &#8220;<strong>developer_application_key<\/strong>&#8220;, &#8220;<strong>client_id<\/strong>&#8221; e &#8220;<strong>client_secret<\/strong>&#8220;;<\/li>\n\n\n\n<li>De posse das informa\u00e7\u00f5es acima voc\u00ea poder\u00e1 inicializar a API no Maker;<\/li>\n\n\n\n<li>No fluxo que vai acionar a API crie um mapa com os itens correspondente no site do BB:\n<ul class=\"wp-block-list\">\n<li>&#8220;<strong>developer_application_key<\/strong>&#8221; (Letras): Obter no site do BB;<\/li>\n\n\n\n<li>&#8220;<strong>client_id<\/strong>&#8221; (Letras): Obter no site do BB;<\/li>\n\n\n\n<li>&#8220;<strong>client_secret<\/strong>&#8221; (Letras): Obter no site do BB;<\/li>\n\n\n\n<li><strong>CERTIFICADO_PFX <\/strong>(Letras): Caminho completo do certificado no servidor em formato PFX (PKCS12). EX: &#8220;<strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\">C:\\meusistema\\webrun\\config\\certificado.pfx<\/mark><\/strong>&#8220;;<\/li>\n\n\n\n<li><strong>CERTIFICADO_SENHA <\/strong>(Letras): Senha do certificado;<\/li>\n\n\n\n<li>&#8220;<strong>access_token<\/strong>&#8221; (Letras) &#8211; (<strong>Opcional<\/strong>) Pode ser usado no lugar dos dois par\u00e2metros  &#8220;<strong>client_id<\/strong>&#8221; e &#8220;<strong>client_secret<\/strong>&#8220;;<\/li>\n\n\n\n<li>&#8220;<strong>RECEBEDOR_NOME<\/strong>&#8221; (Letras) &#8211; Nome do recebedor;<\/li>\n\n\n\n<li>&#8220;<strong>RECEBEDOR_CIDADE<\/strong>&#8221; (Letras) &#8211; Cidade do recebedor;<\/li>\n\n\n\n<li>&#8220;<strong>SERVIDOR_OAUTH_HOMOLOGACAO<\/strong>&#8221; (Letras): <strong>opcional<\/strong>, padr\u00e3o &#8220;oauth.sandbox.bb.com.br&#8221;;<\/li>\n\n\n\n<li>&#8220;<strong>SERVIDOR_HOMOLOGACAO<\/strong>&#8221; (Letras): <strong>opcional<\/strong>, padr\u00e3o: &#8220;<strong>api.sandbox.bb.com.br<\/strong>&#8220;;<\/li>\n\n\n\n<li>&#8220;<strong>BB_VERSAO<\/strong>&#8221; (Letras): (Opcional) Vers\u00e3o da API do PIX a ser utilizada, padr\u00e3o &#8220;<strong>V2<\/strong>&#8220;, informar &#8220;<strong>V1<\/strong>&#8221; para usar a vers\u00e3o antiga. <mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\"><strong>IMPORTANTE<\/strong>: A arrecada\u00e7\u00e3o atrelada ao PIX s\u00f3 existe na V1 (Julho\/2024), \u00e9 necess\u00e1rio informar este par\u00e2metro.<\/mark><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Na fun\u00e7\u00e3o &#8220;<strong>PIX &#8211; Inicializar<\/strong>&#8221; passe os seguintes par\u00e2metros:\n<ol class=\"wp-block-list\">\n<li><strong>Falso <\/strong>(Para homologa\u00e7\u00e3o) ou Verdadeiro pra produ\u00e7\u00e3o;<\/li>\n\n\n\n<li>&#8220;<strong>BB<\/strong>&#8221; (Letras) &#8211; Texto fixo que identifica o Banco do Brasil;<\/li>\n\n\n\n<li>Mapa com os dados copiados do site do BB.<\/li>\n<\/ol>\n<\/li>\n\n\n\n<li>Para a cria\u00e7\u00e3o do PIX informe uma das chaves (item &#8220;<strong>CHAVE<\/strong>&#8220;) de testes: \n\n\n<ul class=\"wp-block-list\">\n<li>Vers\u00e3o 2:\n<ul class=\"wp-block-list\">\n<li>&#8220;<strong>hmtestes2@bb.com.br<\/strong>&#8220;;<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Vers\u00e3o 1:\n<ol class=\"wp-block-list\">\n<li>&#8220;<strong>testqrcode01@bb.com.br<\/strong>&#8220;;<\/li>\n\n\n\n<li>&#8220;<strong>28779295827<\/strong>&#8220;;<\/li>\n\n\n\n<li>&#8220;<strong>7f6844d0-de89-47e5-9ef7-e0a35a681615<\/strong>&#8220;;<\/li>\n\n\n\n<li>&#8220;<strong>3d94a38b-f344-460e-b6c9-489469b2fb03<\/strong>&#8220;;<\/li>\n\n\n\n<li>&#8220;<strong>d14d32de-b3b9-4c31-9f89-8df2cec92c50<\/strong>&#8220;.<\/li>\n<\/ol>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Ap\u00f3s homologar\/testar em desenvolvimento voc\u00ea poder\u00e1 pedir os dados de produ\u00e7\u00e3o.<\/li>\n\n\n\n<li>No servidor de produ\u00e7\u00e3o \u00e9 necess\u00e1rio cadastrar o certificado (junho de 2024), e usar o mesmo na comunica\u00e7\u00e3o <strong>CERTIFICADO_PFX <\/strong>e <strong>CERTIFICADO_SENHA<\/strong>. Caso n\u00e3o fa\u00e7a isso receber\u00e1 um erro de &#8216;bad_certificate&#8217;.<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"block-4ed83c78-6906-4e11-8e69-aaafc005d3fc\">Configura\u00e7\u00e3o do Java<\/h3>\n\n\n\n<p id=\"block-3307c1f5-0e83-4e70-9e64-6288fb158b3c\">O servidor do BB usa criptografia que pode exigir configura\u00e7\u00e3o adicional no Java do servidor.<\/p>\n\n\n\n<p id=\"block-aae93795-d3fb-48f6-b8d7-1e293b9b5c25\">O erro impede a conex\u00e3o\/comunica\u00e7\u00e3o, e nos logs ou na tela \u00e9 retratado com a mensagem:<\/p>\n\n\n\n<pre id=\"block-9e65d20e-4c0a-41c8-b1ff-35dccfd74f2b\" class=\"wp-block-preformatted\"><strong>The size of the handshake message (<mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\">38326<\/mark>) exceeds the maximum allowed size (<mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\">Y<\/mark>)<\/strong><\/pre>\n\n\n\n<p id=\"block-de042cb4-cf2a-40c0-9f81-973407a3a113\">O Java do Webrun\/Tomcat dever\u00e1 ser configurado. Para mais informa\u00e7\u00f5es veja o t\u00f3pico: <a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2023\/05\/configuracao-e-erros-do-java\/\">Configura\u00e7\u00e3o e Erros do Java<\/a>, o t\u00f3pico &#8220;Erro de tamanho da mensagem de Handshake&#8221;.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>IMPORTANTE: Os passos aqui descritos s\u00e3o mera complementa\u00e7\u00e3o e\/ou resumo da documenta\u00e7\u00e3o oficial do BB. Sigam sempre as instru\u00e7\u00e3o oficiais passadas pelo banco. Nem todas as informa\u00e7\u00f5es aqui contidas podem estar atualizadas (\u00faltima revis\u00e3o 06\/09\/2023). NOTA: O suporte da API n\u00e3o cobre o uso\/cadastro\/coleta de informa\u00e7\u00f5es junto ao banco. A inicializa\u00e7\u00e3o do PIX com o [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[246],"tags":[14,251,16,247,17],"class_list":["post-2084","post","type-post","status-publish","format-standard","hentry","category-api-pix-maker-documentacao","tag-api","tag-bb","tag-maker","tag-pix","tag-webrun"],"_links":{"self":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/2084","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/comments?post=2084"}],"version-history":[{"count":31,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/2084\/revisions"}],"predecessor-version":[{"id":3749,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/2084\/revisions\/3749"}],"wp:attachment":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/media?parent=2084"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/categories?post=2084"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/tags?post=2084"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}