Configuração do PIX Bradesco – Celcoin

Este artigo descreve de forma detalhada todos os passos para a configuração da integração do CobranSaaS com o PIX Bradesco.

Para iniciar a configuração é necessário primeiro obter junto ao banco Bradesco:

client_id
client_secret
chave PIX
certificado (arquivos .key e .crt) ou .pfx

Caso o certificado não esteja em formato .pfx é necessário gerar o arquivo .pfx ( com o apoio de pessoal técnico).

Abaixo um exemplo do comando opensssl que um técnico deve executar para criar este arquivo:

openssl pkcs12 -export -out certificado_dinamico_itau.pfx -inkey certificadoKey.key -in certificadoGerado.crt

Para facilitar os cadastros necessários no CobranSaas compilamos uma lista de conteúdos para serem copiados e colados. Esperamos evitar erros de digitação e acelerar o processo de cadastro:

https://qrpix.bradesco.com.br/oauth/token

Os passos que devem ser realizados nas telas de cadastro do CobranSaaS são:

Cadastro de uma INTEGRAÇÃO do tipo OAUTH
Cadastro de uma INTEGRAÇÃO do tipo API (associar a OAUTH)
Cadastro de um MEIO DE PAGAMENTO (associar a integração API)
Alterar um PLANO (associar o MEIO DE PAGAMENTO

Segue o detalhamento destes passos:

1. Cadastrar uma INTEGRAÇÃO do tipo OAUTH.

Esta integração serve para passar as credenciais (cliente_id, client_secret e certificado) para o banco e validar o acesso. Ao final a API do banco retorna o token que será usado na próxima integração que é a integração de cadastro do PIX.

Nesta primeira parte é válido ressaltar que o arquivo .pfx ( marcado em azul ) deve ser adicionado clicando no icone ( marcado em amarelo). E a senha do arquivo .pfx deve ser incluida clicando no cadeado (marcado em vermelho). O campo nome pode ser preenchido como preferir e os demais campos devem ser preenchidos exatamente como estão na imagem:

Nesta segunda parte chamada de Lista do Formulário precisamos dos três campos abaixo.

As informações de Valor dos campos client_id e client_secret são fornecidas pelo banco Itau.

A última parte da tela deve ser preenchida como segue:

2. Cadastrar a INTEGRAÇÃO do tipo API

Essa integração é a que efetivamente registra um PIX junto ao banco. Ela usa a integração anterior para obter o "token". Além disso é necessário fazer o upload do certificado novamente.

Utilidades (copia e cola):

https://qrpix.bradesco.com.br/v2/cobv-emv/

3. Cadastrar MEIO DE PAGAMENTO

Selecionar a integração do Passo 2

Definir um prefixo para o identificador unico do PIX. (Ex.: TIVEAPIX)

Colocar a chave PIX em "chave".

Colocar um texto livre em "solicitacaoPagador"

4. Associar MEIO DE PAGAMENTO ao plano escolhido

Requisito:

MEIO de PAGAMENTO (passo 3)