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 apb004aa, 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:
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. |
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.
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.
Esse programa (html.financeBank) é 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