...

title	Parâmetros de utilização

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

A saída deve conter algo semelhante a:

Image Modified

02. Usuário Pagamento Online:

A tela "Usuário Pagamento Online" 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_apb, ou seja, aqueles que possuem permissão para efetuar pagamentos.

...

Outras Ações / Ações relacionadas

Ação	Descrição

03. Tela de Cadastro de Segurança Online

Esta tela 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, é 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.

...

Campo Servidor RPW
Não é necessário configurar este campo para o processo de Pagamento Online. Essa informação será definida posteriormente no Monitor Pagamentos Online, onde o servidor de execução da rotina será devidamente vinculado.
Campo Código Conexão Online
Informe o mesmo código de conexão que foi cadastrado previamente na tela de Segurança Online (conforme descrito no item 3 da documentação). Esse código contém os dados necessários para autenticação com o banco, como certificados, client ID e client secret.
URL Token
Deve ser informada a URL fornecida pelo banco para obtenção do token de autenticação.
Exemplo: https://trust-open.api.santander.com.br/oauth/token
URL Path
Corresponde ao endpoint principal da API responsável pela execução da transação.
Exemplo: 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.

Image Modified

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.
Portador
Informe o portador correspondente ao banco que irá receber a ordem de pagamento. Somente portadores cadastrados na tela de Usuários Pagamamentos Online serão mostrados.
Borderô
Mostra o borderô em que os títulos serão agrupados. Caso ainda não exista, será apresentado com status "Em Digitação".

Botão “Parâmetros”
O botão Parâmetros permite ao usuário permite configurar os parâmetros para geração dos itens do borderô.
Os campos habilitados estão configurados nas Configurações do usuário, podendo habilitá-los ou não, de acordo com a necessidade.

Campo	Descrição
Assume Forma de Pagamento do Título	Se a opção Assume Forma de Pagamento do Título estiver marcada, o sistema irá utilizar a forma cadastrada no título, ignorando o campo manual
Forma de Pagamento	Permite selecionar como os títulos serão pagos (ex: PIX Transferência ou Pix QR Code).
Assume chave Pix Preferencial	Quando informada forma de pagamento de PIX transferência os títulos selecionados assumirão automaticamente a chave Pix Preferencial.
Pix sem chave	Possibilita o pagamento de título através de PIX informando os dados bancários.
Assume Data de Vencimento	Define automaticamente a data de vencimento do título como a data de pagamento.
Vincula PIS/COFINS/CSLL Automático	Garante que os tributos sejam vinculados automaticamente no pagamento.
Liquida no Estabelecimento do Título	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.
Estabelecimento	Estabelecimento que será gerado o borderô.
Moeda	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.
Histórico Padrão	Selecionar um histórico padrão
Juros	O campo "Juros" virá sempre com o conteúdo inicial igual "Paga Juros", podendo selecionar entre as outras opções "Não pagar Juros" e "Assume Fornecedor".
Servidor RPW	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
Cancela	Fecha a janela sem aplicar as alterações
Aplicar	Salva as configurações para uso no pagamento atual para o usuário corrente

Filtrar
A funcionalidade de Filtrar permite ao usuário selecionar quais títulos deseja exibir na tela para posterior pagamento online.
Os títulos filtrados pela seleção serão mostrados na aba “Disponíveis”.

Abaixo estão os campos disponíveis:

Campo	Descrição
Data de Previsão / Desconto	Escolha entre filtrar pela data de previsão de pagamento ou pela data de desconto.
Estabelecimento	Permite selecionar um ou mais estabelecimentos emissores dos títulos.
Data de Vencimento	Defina intervalos para filtrar os títulos que deseja listar
Série	Informe uma faixa de séries
Título	Informe uma faixa de títulos
Portador	Permite selecionar um ou mais portadores
Forma de Pagamento	Permite selecionar um ou mais formas de pagamento
Tipo de Documento	Escolha entre Títulos, Antecipações/PEF, ou Ambos.
Fornecedor / Matriz	Opção para buscar títulos por fornecedor específico ou pela matriz.
Data de Transação	Defina intervalos para filtrar os títulos que deseja listar
Data de Emissão	Defina intervalos para filtrar os títulos que deseja listar
Espécie	Permite selecionar uma ou mais espécies
Título	Informe intervalos de títulos
Moeda	Permite selecionar uma ou mais moedas
Valor de Saldo	Defina um intervalo de valores a considerar
Situação	Filtrar entre títulos Já Liberados, Não Liberados, ou Ambos.

Outras Ações / Ações relacionadas

Ação	Descrição
Filtrar	Aplica os critérios definidos e carrega os títulos encontrados.
Limpar	Redefine todos os campos para o estado inicial.

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

Aba “Disponíveis”
Títulos disponíveis que serão visualizados depois da aplicação do Filtro e poderão ser adicionados para pagamento.

Outras Ações / Ações relacionadas

Ação

Descrição

Adicionar

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.

Gerenciar Colunas

Permite personalizar quais colunas serão exibidas na Grid.

Pesquisar

Permite realizar buscas específicas dentro da Grid "Disponíveis"

Nota!

Somente os títulos adicionados e relacionados da aba "Selecionados" serão considerados no momento de clicar em “Pagar Online”.

Aba "Selecionados"
Exibe os títulos já adicionados ao borderô para envio ao banco.

Outras Ações / Ações relacionadas

Ação	Descrição
Eliminar Marcados	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.
Editar Marcados	Ao clicar nesse botão exibirá a tela de edição de títulos. Nessa tela serão apresentados os títulos marcados. Deve-se utilizar o botão Próximo e Anterior (que se encontra no final da tela) para passar para os demais títulos marcados. Nessa opção será possível editar 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ô. Adicionar Mensagem - Ao clicar nesse botão exibirá uma tela para Inclusão de uma mensagem complementar que será enviada ao recebedor junto com o pagamento.
Pesquisar	Permite realizar buscas específicas dentro da Grid "Disponíveis"

Tela "Editar Item de Pagamento"

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).
- Títulos Selecionados: Quantidade total de títulos adicionados na operação atual (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.
06. TABELAS UTILIZADAS

...

Árvore de páginas

Versões comparadas

Versão antiga 8

Nova versão 9

Chave

02. Usuário Pagamento Online: