Particularidades de Configuração da API
Banco Bradesco - PIX Puro (QR Code)
 | Atenção | |||||||
| Para melhor visualização das imagens, clique sobre elas. | ||||||||
Para realizar as configurações relevantes ao uso da API PIX Puro do Bradesco pelo BankPlus, siga o guia detalhado:
1º O próprio cliente deve entrar em contato com o banco para a contratação da API Pix - Geração de QR Code. Recomendamos que informem ao banco que utilizam o sistema da BankPlus da Invent Software CNPJ 12.945.116/0001-82, que já possui outras empresas homologadas em produção.
2º Após a contratação da API, é responsabilidade da consultoria e do cliente junto ao banco realizar a homologação, a geração dos certificados e as configurações no contrato bancário.
A API PIX Puro permite a geração de cobranças PIX por QR Code e PIX Copia e Cola, sem código de barras. A mesma credencial atende a cobrança imediata (COB) e a cobrança com vencimento (COBV), que permite data de vencimento futura com multa, juros e desconto.
 | Nota | |||||||
| O PIX Puro é diferente do BolePIX. Para a configuração do BolePIX, acesse: Configuração API para BolePIX Bradesco. | ||||||||
Pré-requisitos
Antes de configurar o contrato bancário, o cliente deve ter em mãos:
• Certificado digital A1 (.pfx) da empresa, cadastrado no Portal Bradesco Developers, utilizado na autenticação com o banco;
• Client ID e Client Secret fornecidos pelo Bradesco após a contratação;
• Chave PIX da empresa cadastrada no Bradesco;
• Certificado SSL do WebHook, conforme quadro abaixo.
 | Importante | |||||||
| Para o recebimento das notificações de pagamento, o Bradesco exige um certificado SSL do tipo OV ou EV emitido por autoridade certificadora pública reconhecida. Certificados do tipo DV (como Let’s Encrypt) não são aceitos. O certificado deve ter como CN a URL do WebHook e validade mínima de 4 meses e máxima de 3 anos. O certificado público deve ser enviado pelo cliente para governancaapis@bradesco.com.br. Esse certificado é diferente do certificado A1 utilizado na autenticação. | ||||||||
Configuração do contrato bancário
Acesse o contrato bancário do Bradesco PIX Puro, na aba Arquivo:
Em Tipo de Ambiente selecione o cenário onde as operações serão realizadas, em produção são operações reais.
| Importante | |||||||
| Alguns campos são preenchidos automaticamente pelo Add-On, os que não forem o banco vai fornecer as informações após a finalização da contratação do serviço, ressaltando que essas informações são únicas para cada cliente. | ||||||||
Em Certificado Digital selecione o certificado A1 da empresa cadastrado no Portal Bradesco Developers.
Após finalizar as definições, basta clicar em Atualizar.
Registro e liquidação do PIX
Para registrar o PIX, acesse BankPlus → Cobrança → Títulos Bancários, selecione o título e realize o Registro Online via API. Após o registro, o campo Nosso Número do título recebe o identificador da cobrança (txid) retornado pelo Bradesco.
Após o pagamento, o serviço BankPlus WebHook consulta as notificações de pagamento do contrato e liquida o título automaticamente. As execuções podem ser acompanhadas nos logs do serviço, no Administrador de Serviços do Invent Apps Services:
Para acompanhar as etapas, selecione o título e clique em Histórico. O título passa pelos status Gerado, Confirmado (PIX Registrado Online pela API) e Liquidado (PIX liquidado pela consulta ao WebHook):
 | Observação | |||||||
| Na liquidação, o BankPlus gera automaticamente o Contas a receber e o lançamento contábil da baixa do título. | ||||||||
Para o processo de homologação é necessário realizar a validação do JSON de envio. No Histórico do título, arraste a barra de rolagem para encontrar a coluna que grava a informação referente ao envio do JSON de comunicação.
