Histórico da Página

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

...

   Image Removed       

...

Selecionar quais portadores bancários o usuário poderá utilizar:
Image Removed

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.

...

Image Removed

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. 

Image Removed

...

Principais Campos e Parâmetros

...

Campo

...

Descrição

...

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

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

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.

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:

1. Selecionar o banco desejado.

2. Clicar nos três pontos à esquerda do banco.

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

...

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

...

 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.

...