Configuração do ambiente, conta, certificado e webhook
Atualizações>>Comunic. Bancária>>Wizard API PIX
Clique no menu >> Banco do Brasil
1º Passo, Tela tela de boas vindas.
Clique em Avançar
2º Passo, Seleção seleção da(s) Conta 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.
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.
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:
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
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 através da execução do JOB/Schedule(FINA892) 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
6º Passo, Tela de conclusão do wizard.
Clique no botão Concluir.
|