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:
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:
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 |
| 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. |
|
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