Configuração do ambiente, conta, certificado e WebHookwebhook
Atualizações>>Comunic. Bancária>>Wizard API PIX
Clique no menu >> Banco do Brasil
![](/download/attachments/725742877/image2023-2-9_11-53-11.png?version=1&modificationDate=1675954391627&api=v2)
1º Passo, Tela de boas vindas.
Clique em Avançar
![](/download/attachments/725742877/image2023-2-9_11-55-23.png?version=1&modificationDate=1675954523770&api=v2)
2º Passo, Seleção da (s) Conta (s).
Neste passo, é possível selecionarmos uma ou mais contas. Para nosso exemplo será selecionada apenas uma conta. Após marcar / selecionar a (s) conta (s) que deseja configurar, clique no botão Avançar.
![](/download/attachments/725742877/image2023-2-9_11-57-28.png?version=1&modificationDate=1675954648287&api=v2)
3º Passo, Credenciais de Conexão.
Nesta etapa será configurado o ambiente de conexão Produção ou Homologação, Tempo de expiração do QR Code após o vencimento e as credenciais de conexão.
![](/download/attachments/725742877/image2023-2-9_16-3-57.png?version=1&modificationDate=1675969437310&api=v2)
Após preenchimento dos dados, clique no botão Avançar. Se as credenciais de conexão, foram preenchidas corretamente, será apresentado a tela abaixo:
![](/download/attachments/725742877/image2023-2-9_16-10-10.png?version=1&modificationDate=1675969810767&api=v2)
Ambiente Define se o registro de cobrança PIX será realizados em ambiente de teste ou ambiente real da instituição financeira (Banco do Brasil) Validade do QR Code após vencimento Define a quantidade de dias corridos após a data de vencimento da cobrança, que QR Code poderá ser pago. Quando preenchido com valor 0 (zero), significa que o QR Code só poderá ser pago até a data de vencimento da cobrança.
Aviso |
---|
| Sempre que a data de vencimento cair em um fim de semana ou em um feriado para o usuário pagador, ela deve ser automaticamente prorrogada para o primeiro dia útil subsequente.
Exemplo 1: Data de vencimento: 25/12/2020 - sexta-feira, feriado. Quantidade de dias após a data de vencimento da cobrança: 0 Tenta-se pagar no dia 25/12/2020, sexta: aceito. Tenta-se pagar no dia 26/12/2020, sábado: aceito. Tenta-se pagar no dia 27/12/2020, domingo: aceito. Tenta-se pagar no dia 28/12/2020, segunda: aceito. Tenta-se pagar no dia 29/12/2020, terça: negado. (QR Code não possui margem para pagamento após a data de vencimento) Exemplo 2: Data de vencimento: 25/12/2020 - sexta-feira, feriado. Quantidade de dias após a data de vencimento da cobrança: 1
Tenta-se pagar no dia 25/12/2020, sexta: aceito. Tenta-se pagar no dia 26/12/2020, sábado: aceito. Tenta-se pagar no dia 27/12/2020, domingo: aceito. Tenta-se pagar no dia 28/12/2020, segunda: aceito. Tenta-se pagar no dia 29/12/2020, terça: aceito. (QR Code possui margem de 1 dia útil para pagamento após a data de vencimento) Tenta-se pagar no dia 30/12/2020, quarta: negado. |
Credenciais de Conexão Usuário e senha disponibilizado pelo Banco do Brasil autorizado a gerar token de acesso ao serviços/recurso da API.
Usuário (Client Id) Identificador público e único no protocolo de autorização (OAuth) do Banco do Brasil.
Senha (Client Secret) Senha conhecida apenas para sua aplicação e o servidor de autorização.
Chave da Aplicação (Application Key) Credencial necessária para acionar as APIS do Banco do Brasil
4º Passo, Certificado.
Aviso |
---|
| Esta etapa é obrigatória apenas para ambiente produção. Para ambiente de homologação, este campos não estão disponíveis para edição pois o Banco do Brasil não exige certificado em ambiente de teste. |
Nesta etapa, serão configurados os nomes e extensão dos arquivos de certificado e chave publica do certificado. Obrigatoriamente os arquivos e devem ter a extensão (.pem)
Após preenchimentos dos campos de chave e certificado, clique no botão Avançar
![](/download/attachments/725742877/image2023-2-9_16-32-4.png?version=1&modificationDate=1675971125190&api=v2)
5º Passo, WebHook
Nesta etapa será configurado endereço (URL) de retorno do WebHook.
Quando preenchido o endereço do WebHook, o Banco do Brasil fica responsável por nos avisar quando ocorrer o recebimento de uma cobrança PIX, e automaticamente o título será baixado no Protheus. Quando não for preenchido, a aplicação Protheus fica responsável por perguntar ao Banco do Brasil por meu da execução do JOB/Schedule se há algum recebimento PIX, e caso exista, o sistema identifica o título e no financeiro e automaticamente efetiva a baixa do título.
Após preenchimento ou não, clique no botão Avançar ![](/download/attachments/725742877/image2023-2-9_16-35-27.png?version=1&modificationDate=1675971327890&api=v2)
6º Passo, Tela de conclusão do wizard.
Clique no botão Concluir.
![](/download/attachments/725742877/image2023-2-9_16-53-20.png?version=1&modificationDate=1675972401093&api=v2) |