Histórico da Página
Índice maxLevel 2 exclude importante style none
| maxLevel | 2 |
|---|---|
| exclude | importante |
| style | none |
01. Portador banco
Para que o pagamento online seja realizado, é necessário que o portador bancário utilizado na baixa esteja devidamente parametrizado para aceitar pagamentos via PIX online, conforme especificado na documentação a seguir: Manutenção Portador Banco - UFN013AA
Parâmetros Gerais APB - APB017TA
Se o seu ambiente utiliza o Servidor RPW em sistema operacional Windows, é obrigatório informar o caminho (diretório) onde o CURL está instalado.
O diretório CURL deve ser configurado exclusivamente quando a funcionalidade de Pagamento Online for utilizada na Central de Pagamentos.
Instalação CURL
A aplicação utiliza o CURL para realizar as requisições HTTP/HTTPS com o banco, e essas requisições exigem autenticação via certificados digitais.
No sistema operacional Windows, a versão padrão do CURL não vem com suporte à LibreSSL, uma biblioteca utilizada para tratamento dos certificados requeridos pelo banco.
Para baixar o CURL para Windows acesse o site oficial: https://curl.se/windows/. Após a instalação, abra o Prompt de Comando (cmd) e execute:
curl --version
...
02. Usuário Pagamento Online:
A tela O programa "Usuário Pagamento Online" (html.userOnlinePayment) permite configurar quais usuários estarão autorizados a realizar pagamentos online via PIX. Nela, define-se quais portadores bancários e quais espécies de títulos cada usuário poderá utilizar para realizar pagamentos, por estabelecimento. A tela é alimentada com os usuários financeiros cadastrados no programa bas_usuar_financ_estab_apbapb004aa, ou seja, aqueles que possuem permissão para efetuar pagamentos.
Ao clicar no botão “Permissão”, será aberta uma nova tela onde é será possível:
- Selecionar quais portadores bancários o usuário poderá utilizar:
| Informações | ||
|---|---|---|
|
...
Os portadores bancários selecionados nesta tela indicam quais portadores estarão disponíveis para o usuário escolher no momento de realizar o pagamento online. Ou seja, eles representam os portadores que poderão ser utilizados para efetuar o pagamento, e não necessariamente correspondem aos portadores usados como filtros para seleção de títulos na tela de pagamento. Ao realizar um pagamento online, o usuário deverá escolher dentre os portadores previamente autorizados nesta configuração qual portador utilizar para aquela operação. |
- Definir as espécies de títulos que ele poderá pagar:
Outras Ações / Ações relacionadas
...
Ação
...
Descrição
03. Tela de Cadastro de Segurança Online
Esta tela O programa "Segurança Online" (html.securityOnline) tem como finalidade cadastrar os dados necessários para realizar a conexão segura com o banco, utilizados nos processos de pagamento online.
...
Como extrair a chave privada e o certificado público de um arquivo .pfx para utilização nas requisições com a API de pagamentos do Banco Santander.:
Extração de Certificados
OpenSSL instalado no sistema (Linux/macOS ou Windows com Git Bash, WSL ou similar).
Arquivo .pfx fornecido pela autoridade certificadora ou gerado previamente.
Senha do certificado .pfx
...
-clcerts: ignora a cadeia de certificados (CA), mantendo só o certificado principal.-nokeys: ignora a chave privada, extrai apenas o certificado.
04. Banco (Financeiro)
Nessa tela, Esse programa (html.financeBank) é necessário configurar a transação online para o banco financeiro.
Acessando a Transação Online
Para configurar os dados de integração da transação online de pagamento, deve-se:
Selecionar o banco desejado.
Clicar nos três pontos à esquerda do banco.
Escolher a opção Transação Online.
Cadastro de Transação Online
Ao acessar a tela de Transação Online, será possível configurar os parâmetros específicos para que o pagamento online funcione corretamente.
Principais Campos e Parâmetros
Campo | Descrição |
|---|---|
| Estabelecimento | Informe o estabelecimento ao qual a transação online estará vinculada. |
| Transação | Tipo da Transação, utilizar Pagamento Online. |
| Código Conexão Online | Relacionar o Código da Conexão Online cadastrado na Tela de Segurança online. |
| Servidor RPW | Servidor RPW |
| URL Token | Endereço utilizado para obtenção do token de autenticação junto ao banco. |
| URL Path | Caminho da URL principal da API do banco onde as transações serão enviadas. |
...
| Informações | ||
|---|---|---|
| ||
Exemplo BB: https://oauth.hm.bb.com.br/oauth/token (ambiente de homologação, para produção consulte portal do banco). Exemplo Itaú: https://devportal.itau.com.br/api/jwt (ambiente de homologação, para produção consulte portal do banco).
Exemplo Santander: https://trust-open.api.santander.com.br/management_payments_partners/v1 |
...
05. Pagar Online
A tela Pagar Online permite a seleção e envio de títulos para pagamento diretamente ao banco por meio da integração com a API bancária. Esta funcionalidade faz parte da Central de Pagamentos e tem como objetivo eliminar a necessidade de exportação de borderôs ou arquivos de remessa, agilizando.
Campos e Funcionalidades:
...
Data de Pagamento
Data em que o pagamento será efetivado no banco. A data em que ocorrerá a implantação do borderô de pagamento.
...
...
Borderô
Mostra o borderô em que os títulos serão agrupados. Caso ainda não exista, será apresentado com status "Em Digitação".
...
|
...
|
...
|
...
Campo
...
Descrição
...
|
...
Permite selecionar como os títulos serão pagos (ex: PIX Transferência ou Pix QR Code).
...
Quando assinalado este campo, determina que a liquidação dos títulos deve ocorrer no estabelecimento do próprio título, desconsiderando o estabelecimento informado no lote.
Exemplo:
Em um lote de pagamento do estabelecimento A são informados títulos do estabelecimento B e C, quando assinalado esse parâmetro, esses títulos são baixados no seu estabelecimento de implantação, ou seja, nos estabelecimentos B e C.
Dessa forma, não será gerado o movimento de baixa por transferência de estabelecimento e sim um movimento de baixa normal.
...
Este campo sempre será preenchido com a moeda REAL, pois o meio de pagamento utilizado nesta rotina é o PIX.
O campo estará desabilitado para edição pelo usuário.
...
Este campo define o servidor responsável pela execução da rotina de pagamento em segundo plano (background).
Quando o usuário clica em “Pagar Online”, o processo não é executado imediatamente em tempo real na interface. Em vez disso, a solicitação é enviada para o servidor RPW, que processa o pagamento dos títulos em background.
Isso permite que o usuário continue utilizando o sistema normalmente sem necessidade de aguardar a conclusão do pagamento.
O acompanhamento do andamento dos pagamentos deve ser feito através da tela "Monitor de Pagamentos Online", que exibe o status de cada título processado.
Outras Ações / Ações relacionadas
...
Ação
...
Descrição
...
Abaixo estão os campos disponíveis:
...
Campo
...
Descrição
...
Permite selecionar um ou mais estabelecimentos emissores dos títulos.
...
Fornecedor / Matriz
...
Opção para buscar títulos por fornecedor específico ou pela matriz.
...
Outras Ações / Ações relacionadas
...
Ação
...
Descrição
...
IMPORTANTE!
Use esse filtro para limitar os dados carregados na tela, otimizando o desempenho da operação e facilitando a seleção de títulos
...
Ação
...
Descrição
...
Permite adicionar o título selecionado ao Lote do Borderô. Estes títulos serão exibidos na Aba "Selecionados".
Depois de clicar no botão "Adicionar" Os títulos incluídos não serão mais apresentados como Disponíveis.
Após a adição, os valores do (Big Numbers) da tela serão totalizados e agrupados conforme os critérios definidos nos filtros.
É possível realizar múltiplas adições em sequência, inclusive alterando filtros e buscando novos títulos sem perder os que já foram previamente adicionados.
...
Nota!
Somente os títulos adicionados e relacionados da aba "Selecionados" serão considerados no momento de clicar em “Pagar Online”.
...
Outras Ações / Ações relacionadas
...
Ação
...
Descrição
...
Ao clicar nesse botão exibirá uma tela com os títulos marcados e se informado "Sim" serão eliminados esses títulos do lote de Borderô. Nessa opção será possível eliminar mais do que um item por vez.
...
Acões Individuais
Editar - Ao clicar nesse botão exibirá a tela "Editar Item de Pagamento". Nessa tela será possível realizar a edição do título marcado.
Eliminar - Ao clicar nesse botão exibirá uma tela com o título selecionado e se informado "Sim" será eliminado esse títulos do lote de Borderô.
...
Exemplo BB: https://pagbb.mtls.api.hm.bb.com.br/v1 (ambiente de homologação, para produção consulte portal do banco). Exemplo Itaú: https://devportal.itau.com.br/sandboxapi/itau-ep9-gtw-sispag-ext/v1 (ambiente de homologação, para produção consulte portal do banco). |
05.APB001 - Manutenção Parâmetros Estab APB
Para os pagamentos via Banco do Brasil (PagBB), é necessário preencher os seguintes campos: "Chave Acesso PagBB" e "Contrato Pix PagBB".
| Informações | ||
|---|---|---|
| ||
Estas informações são fornecidas pelo Banco do Brasil |
Estas informações são fornecidas pela própria instituição bancária.
06.UTB099 - Manutenção Contas Correntes
Para os pagamentos via Banco Bradesco é necessário cadastrar a chave PIX para a conta pagadora.
| Informações | ||
|---|---|---|
| ||
Caso a chave não seja informada, o sistema assumirá automaticamente o tipo "AGENCIACONTA". |
...
Possibilita realizar a edição de Borderôs podendo ser alterado o valor de pagamento, juros, multas, descontos, abatimentos, vinculação de impostos no pagamento, antecipações, entre outros. Na Grid de Selecionados existe um botão para Editar, ao clicar abrirá uma nova tela, selecionando um único item. Será possível também selecionar vários itens, marcando os títulos da Grid e selecionando o botão Editar Marcados.
Nessa tela de edição de itens de Borderô serão apresentados os valores na Moeda de Pagamento e também ao lado na Moeda do Documento.
...
Resumo de Valores (Big Numbers)
Na parte superior da tela, são exibidos os Big Numbers, que funcionam como indicadores visuais rápidos para acompanhar o andamento da operação respeitando sempre o filtro aplicado:
...
A Adicionar: Total em valor dos títulos disponíveis para pagamento, que ainda não foram adicionados à seleção.
...
Total Selecionado: Valor total dos títulos que já foram selecionados e que serão enviados na transação online (Aba Selecionados).
...
Botão “Pagar Online”
Após selecionar os títulos e definir os parâmetros, clique neste botão para realizar o envio da transação ao banco, o sistema realiza as validações necessárias e, em seguida, redireciona automaticamente o usuário para a tela "Monitor Pagamentos Online", onde será possível acompanhar em tempo real o status de envio e retorno dos pagamentos processados.
...
IMPORTANTE!
Use esse box para destacar informações relevantes e/ou de destaque.
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas