Como emitir PIX pela API do Bradesco

[leonardo.figueiredo]

Fala, desenvolvedor! Beleza? Nesse post, irei mostrar para você como obter as credenciais para emissão do PIX para o Bradesco e realizar seu cadastro na API Pix da TecnoSpeed para já sair emitindo.

Essa documentação está dividida em duas partes: obtenção das credenciais no Bradesco e registro na API PIX da TecnoSpeed. Para começar, é necessário que você tenha cumprido todos os requisitos apresentados abaixo.

Pré-requisitos:

• Conta ativa no banco Bradesco;
• Um contrato ativo com a API do PIX da Tecnospeed.

Vamos lá! Para solicitar as credenciais do banco e cadastrar na API da TecnoSpeed, é necessário que:

1) Solicite as credenciais junto ao gerente do banco

Para a emissão do PIX, é necessário que o banco forneça as credenciais client_ID e client_Secret. Essas credenciais funcionam como login e senha para o acesso à API PIX do Bradesco. O processo está descrito também no manual no banco, na seção "Jornada de adesão".

 

2) Envie ao banco um certificado digital

A equipe de implementação de Cash Management do Bradesco entrará em contato com você e solicitará o envio da chave pública de um certificado em formato .cer, .crt ou .pem. Esse certificado será utilizado, posteriormente, junto com a senha, para o cadastro das credencias na API PIX da TecnoSpeed.

 

3) Cadastre sua empresa (company) na API PIX da TecnoSpeed

Nessa parte, iremos cadastrar os dados da empresa na API da TecnoSpeed. É importante garantir que os dados estejam cadastrados corretamente, pois serão enviados ao banco para a emissão do PIX e também estarão presentes no EMV do PIX. Na rota de cadastro de companies, preencha o body da requisição com os dados da empresa.

{
	"zipcode": "87045410",
	"name": "Usuario de testes",
	"email": "xxxxx@gmail.com",
	"cpfCnpj": "xxxxxxxxx",
	"city": "Maringa",
	"state": "PR"
}

 

4) Cadastro das credenciais na API PIX da TecnoSpeed

A documentação para cadastro das contas de emissão em nossa API encontra-se aqui. Para o cadastro, você deve estar com o clientId, clientSecret, e certificado em mãos, além de uma chave PIX gerada pelo aplicativo do banco. A requisição para a criação da conta ficará nesse formato:

{
    "bankCode": "237",
    "clientId": "client_id",
    "clientSecret": "client_secret",
    "pixKey": "chave_pix"
}

Feito isso, será retornado um identificador (id) da conta cadastrada. Agora, é necessário vincular um certificado digital à conta. A requisição com o certificado, documentada aqui, ficará da seguinte forma (usando o Insomnia como exemplo):

 

5) Pronto, agora só começar a emitir!

Nossa documentação para a geração de PIX encontra-se neste link.

 

Bibliografia:

• Documentação da API PIX Bradesco: https://exclusive.bradesco/pix/assets/docs/api_pix_200.pdf
• Documentação da API PIX TecnoSpeed: https://docs.pix.tecnospeed.com.br/

[zhouzhou123456]

https://pix.tecnospeed.com.br/
Usei este link para solicitar um 403
Qual é o problema

[Eduardo_Montanhole]

Em 18/10/2021 at 03:14, zhouzhou123456 disse:

https://pix.tecnospeed.com.br/
Usei este link para solicitar um 403
Qual é o problema

Ola, o erro 403 aconteceu por falta de credenciais ativas para o disparo da requisição.

[Gines]

Algumas informações adicionais a respeito desse processo! 

Para solicitar as credenciais para emitir PIX utilizando a API do Bradesco é necessário que o certificado seja um certificado do tipo A1 com validade mínima de 4 meses e máxima de 3 anos.

Antes de entrar em contato com o suporte pedindo o cadastramento do certificado, o titular da conta precisa entrar em contato com o seu gerente de conta e pedir a ativação para emitir PIX via API do Bradesco.

Após esse processo com o seu gerente de conta, siga o passo a passo abaixo:

Solicitando as credenciais em homologação (Deve ser realizado primeiro) 

- Envie as informações para o e-mail suporte.api@bradesco.com.br e é obrigatório
colocar em cópia sua gerente de conta Bradesco. 
- Solicite primeiramente as credenciais de homologação. 
- É preciso seguir um padrão no corpo do texto conforme o banco pede. 

Exemplo de e-mail que deverá ser enviado para solicitar as credenciais de Homologação/Produção:

“Bom dia/Boa tarde (@suporte.api@bradesco.com.br), tudo bem?



(email do gerente aqui) que nos lê em cópia é a gerente da conta que estamos solicitando o cadastramento do certificado para utilizar a API de geração de PIX.



Nome, telefone e e-mail do responsável por fazer a validação após ativação

 - fulando de tal, 44 99999-9999, fulano@exemplo.com.br

Nome, telefone e e-mail do responsável pelo certificado:

      - fulano de tal, 44 99999-9999, fulano@exemplo.com.br



Em anexo segue o certificado para cadastramento. 





Aguardo o retorno com as credenciais de HOMOLOGAÇÃO.”

 

 

Em alguns dias o banco retornará no e-mail informando que o certificado foi cadastrado, e fornecerá as credenciais de homologação. 

Utilize o ambiente de homologação do Bradesco para emitir PIX pois é necessário encaminhar um JSON de PIX para solicitar as credenciais de produção. (collection em anexo!) 

O próximo passo é solicitar as credenciais de produção. Siga o passo-a-passo:

“Bom dia/Boa tarde (@suporte.api@bradesco.com.br), tudo bem?



(email do gerente aqui) que nos lê em cópia é a gerente da conta que estamos solicitando o cadastramento do certificado para utilizar a API de geração de PIX. Realizamos as validações necessárias no ambiente de homologação e gostaríamos de solicitar as credenciais de produção.



Data desejada para ativação em produção: ex: 26/05/2023

(As credenciais são geradas normalmente às terças e quintas-feiras, com data mínima para ativação 7 dias após a solicitação, então atente-se no momento da escolha da data)

Nome, telefone e e-mail do responsável por fazer a validação após ativação

 - fulando de tal, 44 99999-9999, fulano@exemplo.com.br

Nome, telefone e e-mail do responsável pelo certificado:

      - fulano de tal, 44 99999-9999, fulano@exemplo.com.br



O certificado se encontra anexo a este e-mail.



Abaixo está a confirmação da emissão de PIX no ambiente de homologação do Bradesco:



(inserir aqui o JSON e Qrcode)



Aguardo seu retorno com as credenciais.”

 

Quando o banco disponibilizar essas informações, basta cadastrá-las junto a sua conta na API PIX. Após, realize o upload do certificado e pode iniciar suas emissões no ambiente de produção.

 

Caso haja qualquer dúvida, entre em contato com o nosso suporte!

Bradesco - Homologacao