Banco Santander usando API no ReceitaNet

Publicado por André Andrade em

ReceitaNet • Integração Bancária

🏦 Como Configurar o Banco Santander usando API no ReceitaNet

Automatize boletos, reduza erros e ganhe mais agilidade no processo de cobrança utilizando a integração do ReceitaNet com a API Santander.

Integração ReceitaNet com Santander via API

💡 Neste tutorial você aprenderá: 

Configurar a API no Santander, obter as credenciais, cadastrar a integração no ReceitaNet e validar boletos e PIX antes de colocar a cobrança em produção.

0.0

📌 Visão Geral da Integração

Entenda o objetivo antes de iniciar a configuração.

📲 Automatize boletos, reduza erros e ganhe agilidade na sua cobrança com a integração via API SANTANDER.

✅ A lógica é simples: 

Primeiro você cria e habilita a integração no Santander. Depois utiliza as informações fornecidas pelo banco para criar uma nova integração API dentro do ReceitaNet.

1.0

🔧 Etapas para Configuração

Configure primeiro no banco e depois cadastre as informações no ReceitaNet.

ETAPA 1

🏦 Configuração no Santander

O Banco Santander utiliza integração por API e pode ser configurado para trabalhar diretamente com o sistema ReceitaNet.

⚠️ Importante: o cadastro/conta Santander precisa estar habilitado para cobrança via API e também com o PIX devidamente ativado na API.

⚙️ Acesse o Santander Developer como administrador

🔗
https://developer.santander.com.br/login

Portal Developer Santander

🧭 Passo a Passo no Santander Developer

1️⃣ Acesse o portal

Entre no portal Santander Developer como administrador e informe suas credenciais de acesso.

🔗
Acessar Santander Developer

2️⃣ Crie a aplicação

Após o login, clique em Criar Aplicação de Produção.

Depois, selecione a conta/empresa que será vinculada à integração.

3️⃣ Selecione a conta

Selecione a conta da empresa que será utilizada na integração.

4️⃣ Escolha as APIs

Selecione as APIs necessárias para a integração:

  • Cobrança de Exportação
  • Emissão de Boletos
  • Pix – Geração de QR Code

5️⃣ Envie o certificado digital

O Santander solicita o certificado no formato .pem.

Caso seu certificado esteja em .pfx, utilize o conversor disponibilizado pela ReceitaNet:

6️⃣ Finalize a aplicação

Após enviar o certificado, informe uma descrição para a API.

Exemplo: Integração ReceitaNet Santander

Depois de finalizar, a aplicação poderá aparecer como pendente.

⏱️ Aguarde aproximadamente 2 minutos e clique em Atualizar.

7️⃣ Acesse as credenciais

Quando a aplicação estiver ativa, clique em Acessar.

Ao lado da aplicação aparecerá o botão para visualizar as credenciais:

🔐 CLIENT_ID
🔐 CLIENT_SECRET

✅ Resultado desta etapa: 

O Santander irá gerar o seu CLIENT_ID e CLIENT_SECRET. Guarde essas informações, pois serão utilizadas no ReceitaNet.

ETAPA 2

💻 Configuração dentro do ReceitaNet

⚠️ Muito importante: caso já possua no ReceitaNet integração Santander por CNAB, NÃO ALTERE NADA nessa configuração. Crie uma NOVA INTEGRAÇÃO utilizando API – SANTANDER.

📍 Caminho no sistema

1️⃣ Vá até Cadastros Diversos > Bancos.
2️⃣ Clique em Incluir Novo Banco.

🧾 Preencha os campos obrigatórios:

🏦 Banco: API – SANTANDER
🔐 CLIENT_ID: fornecido pelo banco
🔐 CLIENT_SECRET: fornecido pelo banco
📜 CERTIFICADO PFX
🔑 SENHA do Certificado PFX
💠 Chave PIX
🏢 Agência
🧾 Conta: informe o número da conta com dígito, sem traço e sem espaço
📄 Cedente e Convênio: costumam ser iguais
📍 Local de Pagamento:
PAGÁVEL PREFERENCIALMENTE NAS AGÊNCIAS DO SANTANDER

📷 Exemplo de tela preenchida

🚨 Atenção: se já existir um Santander do tipo CNAB, não altere essa configuração. Crie um NOVO banco API e mantenha os dois cadastros.

2.0

📤 Após a Configuração

Não coloque a integração em produção sem antes realizar os testes.

🧪 Teste obrigatório antes da produção

Gere 2 boletos de teste antes de colocar a integração em produção.

1️⃣ Pague o primeiro boleto utilizando o código de barras.
2️⃣ Pague o segundo boleto utilizando o PIX.
3️⃣ Confira se os dois pagamentos tiveram baixa automática no ReceitaNet.
✅ SOMENTE DEPOIS DE VALIDAR OS DOIS TESTES, COLOQUE A INTEGRAÇÃO EM PRODUÇÃO.

3.0

🔗 Boletos Existentes Criados com CNAB

Os boletos antigos e os novos boletos da API possuem comportamentos diferentes.

💡 Entenda esta diferença

Boletos existentes, criados utilizando CNAB no Santander, NÃO migram para API.

Somente os boletos criados pela API possuem webhook.

4.0

❓ Dúvidas Frequentes

Respostas rápidas para as principais dúvidas sobre a integração Santander.

💡 É preciso ativar a cobrança registrada no Santander? 

Sim.

💡 Qual o prazo de compensação? 

1 a 3 dias úteis.

💡 Quantos meses de boletos podem ser emitidos? 

A API Santander permite emissão até 12 meses à frente do mês atual.

💡 Boletos criados antes da API passarão a utilizar a API? 

Não.

5.0

📞 Suporte e Contato

Em caso de dúvidas sobre liberação bancária ou credenciais.

🏦 Entre em contato com seu gerente Santander para orientações adicionais sobre habilitação da conta, cobrança registrada, API, PIX ou credenciais bancárias.

✅ Pronto!

Após realizar os testes e confirmar as baixas corretamente, sua integração Santander API estará preparada para utilização no ReceitaNet.

💬

Categorias: Bancos

André Andrade

Pós Graduação em Engenharia de Redes e Sistemas de telecomunicações - Inatel