...
| Expandir |
|---|
|
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 de boas vindas.
Clique em Avançar
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.
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 através da execução do JOB/Schedule(FINA892) se há algum recebimento PIX, e caso exista, o sistema
identifica o título no financeiro e automaticamente efetiva a baixa.
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.
...
