...
Permite configurar a conexão com o TPI (TOTVS Pagamentos Instantâneo) e ou Banco do Brasil, os Agendamentos (Schedule) de monitoramento, geração de QRCode e processamento do PIX.
Informações |
---|
|
- Para utilização do wizard é necessário a utilização da versão 20.3.1.3 ou superior do AppServer.
- Para utilizar o wizard no release 12.1.2210 deverá ser realizado a inclusão da rotina no menu manualmente via configurador.
|
02. API'S PIX CONTAS A RECEBER
Expandir |
---|
title | TOTVS Pagamentos Digitais Pagamento Instantâneo (TPI) |
---|
|
Tela 1 - Escolha de Produto Image Added
Tela 2 - Informações Image RemovedImage Added Tela 2 3 - Credenciais Tenant Nesta tela será necessário informar o Tenant, Usuário, Senha, Código Externo da Unidade de Negócio e o código do Ponto de Venda cadastrados no RAAS. Para obter mais informações sobre a configuração no RAAS acesse o link: TOTVS Pagamentos Digitais Image Removed : https://tdn.totvs.com/display/public/TPD/TOTVS+Pagamentos Image Added Tela 4 Tela 3 - Validação de Conexão
Tela 4 5 - TOTVS PIX Nesta tela será necessário informar Banco, Agência e Conta.
Tela 5 6 - Agendamento Agendamento (Schedule) Ao avançar essa tela será configurado automaticamente um agendamento na filial logada. Image RemovedImage Added Tela 6 7 - Encerramento Processo Image RemovedImage Added
|
Expandir |
---|
|
Configuração do ambiente, conta, certificado e WebHookwebhook
Atualizações>>Comunic. Bancária>>Wizard API PIX
Clique no menu >> Banco do Brasil Image RemovedImage Added
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 e as credenciais de conexão. Image Added
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: Image Added
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: 1Tenta-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
Image Added
5º Passo, WebHook
Nesta etapa será configurado endereço (URL do REST do Protheus) de retorno do WebHook.
Webhook é um serviço onde o banco envia informações para o ERP Protheus.
Nesse passo será informado o endereço do serviço REST do Protheus para cadastro no serviço de WebHook do banco do Brasil.
Será necessário ter o serviço previamente configurado, para mais informações verifique a documentação de configuração REST.
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
Image Added
6º Passo, Tela de conclusão do wizard.
Clique no botão Concluir.
Image Added