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
...
...
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.
...
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.
...
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:
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.
...
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
...
tela Pagar Online permite selecionar e enviar títulos para pagamento diretamente ao banco, por meio de integração com a API bancária. Essa funcionalidade, integrante da Central de Pagamentos, tem como principal objetivo eliminar a necessidade de exportação de borderôs ou arquivos de remessa, tornando o processo mais ágil e eficiente.
Ações Principais
| Deck of Cards | |||||
|---|---|---|---|---|---|
| |||||
|
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.
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
Fornecedor / Matriz
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
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).
...
|
...
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ô.
...
|
|
...
|
...
|
...
|
...
|
...
|
...
IMPORTANTE!
Use esse box para destacar informações relevantes e/ou de destaque.
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas