x-bb-portal-devx-cnpj-parceiro no Header da API do Banco do Brasil

[Aggille Sistemas de Gestão]

Bom dia... recebi um email do banco do Brasil, solicitando que seja incluída uma tag x-bb-portal-devx-cnpj-parceiro no header das requisições por api.
Nessa tag deve ir o cnpj da minha empresa. Ja existe essa propriedade no componente ?
Segue abaixo íntegra do email ...

 

Boa tarde, parceiro AGGILLE SISTEMAS DE GESTAO LTDA, 

No Banco do Brasil, buscamos sempre entregar aos nossos clientes as soluções mais modernas e eficientes do mercado. E, para que ocorra o processo de melhoria contínua em nossos serviços, é muito importante comprovarmos, por exemplo, se as chamadas de APIs que chegam até nós, são originadas por alguma solução tecnológica criada e gerenciada por você, parceiro.

Essa identificação permite que seus clientes integrados com as nossas APIs desfrutem de vantagens e tarifas exclusivas e que você parceiro, tenha acesso a canais de suporte técnico priorizado e a novos recursos e APIs de maneira antecipada, além de outras vantagens, como participação em eventos do Banco do Brasil e a possibilidade de ter a sua marca divulgada no nosso portal de APIs (https://www.bb.com.br/site/developers/), podendo utilizar a marca BB em suas ações promocionais.

Para que essa identificação ocorra de forma tempestiva, é necessário que se inclua no header de suas chamadas de API a seguinte chave-valor:

x-bb-portal-devx-cnpj-parceiro = cnpj_da_sua_empresa

Esta inclusão deve ser feita nas chamadas aos seguintes endpoints:

·       https://api-ip.bb.com.br/checkout/v1

·       https://api-bbpay.bb.com.br/checkout/v2

·       https://api.bb.com.br/cobrancas/v1

·       https://api.bb.com.br/cobrancas/v2

·       https://api.bb.com.br/dda/v1

·       https://api-extratos.bb.com.br/extratos/v1

·       https://api-ip.bb.com.br/pagamentos-lote/v1

·       https://api-ip.bb.com.br/pagamentos-lote/v2

·       https://api.bb.com.br/pix/v1

·       https://api-pix.bb.com.br/pix/v2

·       https://api.bb.com.br/pix-bb/v1

·       https://api.bb.com.br/recebimentos-bb/v3

·       https://api-ip.bb.com.br/servicos-arrecadacao/v1

·       https://api-ip.bb.com.br/servicos-arrecadacao/v2

·       https://api-ip.bb.com.br/servicos-arrecadacao/v3

·       https://api.bb.com.br/validacao-contas/v1

Obs.: sempre que, porventura, forem criadas pelo BB novas APIs e/ou novos endpoints, a inclusão da chave também deverá ser feita.

Como o uso da chave x-bb-portal-devx-cnpj-parceiro no header, não será mais obrigatório o uso da app-key única do parceiro nas chamadas, podendo (recomendamos) utilizar a app-key do cliente final.

A partir de 01/07/2024, só reconheceremos como chamadas feitas através de suas soluções, aquelas que contenham essa chave-valor. Sem ela, consideraremos que a chamada foi realizada diretamente pelo cliente final, sem o uso de suas soluções tecnológicas.

Estaremos à disposição para ajudá-los nessa alteração e para tirar eventuais dúvidas:

·       pelo fórum do Portal Developers

·       pelo e-mail [email protected]

Ainda assim, se necessária uma reunião 

[Aggille Sistemas de Gestão]

vou adicionar a propriedade no componente, implementar no BB e submeter para a aprovação...