Skip to main content

Guia de Integração | Santander PIX

sgptsmx-petroleo.png

1. Introdução

A integração com APIs PIX para a emissão de cobranças representa um avanço estratégico para empresas que buscam automatizar e otimizar sua gestão financeira. Ao conectar diretamente o SGP às instituições bancárias, elimina-se a necessidade de processos manuais, como conciliações demoradas e verificações externas, garantindo agilidade e precisão na liquidação dos pagamentos.

Entre os principais benefícios dessa integração, destacam-se:

  • Automatização do processo de cobrança: o QR Code PIX é gerado e registrado automaticamente a partir do SGP, atendendo às regras do Banco Central e garantindo maior agilidade no processo.

  • Retornos instantâneos ou em até 15 minutos: a confirmação do pagamento ocorre em tempo real (ou no máximo em 15 minutos, conforme regulamentação do BACEN), permitindo atualização imediata dos recebimentos no sistema.

  • Redução de erros e inconsistências: a comunicação direta evita falhas comuns em processos manuais, como atrasos no reconhecimento de pagamentos ou divergências de valores.

  • Maior segurança e confiabilidade: os dados são transmitidos de forma padronizada e segura, reduzindo riscos de fraudes ou informações incorretas.

  • Controle centralizado: todas as movimentações financeiras ficam registradas no SGP, facilitando a conciliação e o acompanhamento da inadimplência.

Assim, a integração PIX via API não apenas simplifica o processo de cobrança, como também garante retornos rápidos, maior eficiência operacional, segurança e controle estratégico sobre o fluxo de caixa da organização.

Antes de iniciar o processo, consulte nossa FAQ – Atenção à Segurança da sua Integração! para garantir uma implementação mais segura e eficiente.

2. Dados necessários para integrar ao SGP

Para realizar a integração da API PIX do Santander, é necessário inicialmente gerar as credenciais de acesso no portal Santander Developers.

As credenciais usadas para integração devem geradas com auxilio do suporte do banco.

Durante esse processo, serão exigidos alguns dados e arquivos obrigatórios:

  • Client ID

  • Client Secret

  • Certificado Digital A1 + Senha

  • Chave PIX

Atenção ao Certificado Digital A1:
O certificado digital A1 utilizado na comunicação com o Santander deve possuir validade superior a 30 dias. Certificados com prazo inferior a esse limite serão automaticamente recusados pelo banco, impossibilitando a execução de operações, como emissão de cobranças ou consultas de retorno.

Assim, é essencial que a empresa mantenha um controle preventivo da validade do certificado, garantindo a continuidade da integração sem interrupções.

3. Cadastro do Gateway PIX

Com os dados em mãos, podemos integrar o Gateway ao SGP para emissão de PIX.

  • No Menu Principal, acesse Financeiro (❶), depois vá em Cadastros (❷) e, em seguida, clique em Gateway de Pagamento (❸).

Modelo_de_imagem_horizontal_com_sombra.png

Esse modelo de integração é apenas para emissão de QRCode PIX, caso queira uma integração de Boleto Hibrido, verifique a documentação correspondente!

Clique no botão Cadastrar e preencha da seguinte forma:

  1. Nome da Integração: Santander API
  2. Descrição
  3. Usuário: Client ID
  4. Senha: Client Secret
  5. Chave PIX: Chave PIX da conta Santander
  6. Habilite Pagamentos via PIX
  7. Selecione o Portador Santander
  8. URL de Notificação: https://url_do_seu_sgp/ws/santander/id_do_gateway/notificacao
  9. Insira o parâmetro: tipo_chave_pix=TIPO
    1. CPF = Chave PIX via CPF
    2. CNPJ = Chave PIX via CNPJ
    3. CELULAR = Chave PIX via Celular
    4. EMAIL = Chave PIX via E-mail
    5. EVP = Chave PIX via Chave aleatória
  10. Insira o Certificado A1 e a senha

Antes de cadastrar a URL de notificação, verificar a URL verificar a seção de Informações Adicionais

Imagem de Referência (API PIX)

pix.jpeg

4. Informações Adicionais
  • A URL de notificação deve obrigatoriamente utilizar o protocolo HTTPS. Caso ainda não possua um endereço com HTTPS, entre em contato com o suporte para verificar a possibilidade de aquisição de um subdomínio SGP.
  • No cadastro da URL de notificação, o ID do Gateway é indispensável para o correto processamento dos retornos.
    • Para identificá-lo, siga os passos:
      • Crie um gateway deixando o campo “URL de notificação” em branco.
      • Anote o ID gerado.
      • Em seguida, cadastre a URL de notificação utilizando esse ID.
  • Para integrações que exijam uma rotina de processamento de retorno, é necessário acionar o suporte para que seja feita a configuração dessa rotina.
  • A integração do PIX Avulso pode ser vinculada a portadores locais ou portadores outros bancos que não tenham emissão de pix.

  • A seguir, listamos algumas funcionalidades disponíveis para a sua integração:

Funcionalidade Santander PIX
PIX - Emissão ✔️
PIX - Cancelamento ✔️
PIX - Tempo de Baixa Rotina/Webhook
Parâmetros

pixvencimento=1 (habilitar cobv)

forcar_atualizacao_pix=1 (atualizar pix cob)
É cov ou cobv? ambos
PIX Híbrido ou Avulso? Avulso
Alterações Não há

 

Para essa integração existem dois tipos de PIX o  Pix Cob e Pix CobV :

  • Pix Cob : Gera um QR Code para pagamento imediato, sem data de vencimento. Ideal para pagamentos instantâneos e avulsos. Nessa modalidade, no SGP esse PIX expira no dia do vencimento do boleto.
    • Sendo possivel usar o parâmetro abaixo para gerar um novo pix atualizado após expirar. 
      forcar_atualizacao_pix=1

  • Pix CobV (Cobrança com Vencimento)  : Permite definir uma data de vencimento e aplicar juros, multas e descontos. Usado para cobranças recorrentes, como boletos. Nessa modalidade, no SGP o PIX acompanha o "vencimento" do boleto atualizando Multa e Juros diários. Pode ser habilitado com o uso do seguinte parâmetro:

    pixvencimento=1

Para usar os parâmetros acima é preciso verificar com o banco quais escopos estão ativos para a sua conta.

tsmx-petroleo.png

Back to top