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.
Ao clicar no botão “Permissão”, será aberta uma nova tela onde é possível:
Selecionar quais portadores bancários o usuário poderá utilizar:
Importante: 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 |
|---|---|
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.
Pelo botão "Adicionar Conexão" permite a inclusão de um novo cadastro contendo:
Principais Campos e Parâmetros
Campo | Descrição |
|---|---|
| Conexão Online | Nome ou identificador da conexão com o banco. |
| Descrição | Campo livre para identificação do registro. |
| ClientID | Identificador fornecido pelo banco para autenticação. Este campo é criptografado no momento do salvamento. |
| SecretID | Chave secreta fornecida pelo banco. Este campo é criptografado no momento do salvamento. |
| Importar Certificado Digital | Onde deve ser carregado o certificado público no formato .pem. |
| Importar Chave | Onde deve ser carregada a chave privada no formato .key. |
Após a inclusão dos dados ClientID e SecretID, não será possível visualizá-los por questões de segurança.
Caso seja necessário alterar o ClientID ou o SecretID:
O usuário deverá informar os dados novamente do zero, substituindo os anteriores.
Não é possível visualizar ou copiar os valores já salvos.
Ao abrir a tela para editar uma conexão existente, os campos estarão sempre em branco.
Para o banco Santander, a integração com a API de Pagamentos Online do Banco Santander requer a utilização de certificados digitais do tipo cliente para autenticação mTLS (mutual TLS). Esse tipo de autenticação garante uma conexão segura e autenticada entre a aplicação cliente (sua aplicação) e os servidores do banco.
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.
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
1. Comando para converter o .pfx para a chave privada (formato KEY). Será solicitada a senha do .pfx.
openssl pkcs12 -in certificado.pfx -nocerts -nodes -out chave_privada.key
-nocerts: ignora o certificado, extrai apenas a chave privada.
-nodes: extrai a chave sem criptografia (sem senha), o que normalmente é necessário para uso em integrações automáticas com APIs.
2. Comando para extrair o certificado público (.pem)
openssl pkcs12 -in certificado.pfx -clcerts -nokeys -out certificado_publico.pem
-clcerts: ignora a cadeia de certificados (CA), mantendo só o certificado principal.
-nokeys: ignora a chave privada, extrai apenas o certificado.
Nessa tela, é necessário configurar a transação online para o banco financeiro.
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.
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. |
OBESERVAÇÂO:
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
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.
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. |
| 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 |
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. |
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" |
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 |
|---|---|
| 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.
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.
Use esse box para destacar informações relevantes e/ou de destaque.
