Integração Hubsoft com Santander

Sobre o Santander

O Santander é um grupo bancário global com origem em Santander, na Cantábria, Espanha, fundado em 1857. No Brasil, atende em todas as regiões. Para o provedor, é um banco de cobrança que reúne boleto, Pix, Pix Automático e débito automático no mesmo convênio.

O que a integração faz

• Boleto pela API V2: registro, alteração de vencimento, baixa e abatimento enviados ao banco pela API. O pagamento é identificado pela rotina de verificação de boletos na API Bancária.
• Boleto pela API V1: só o registro automático, para quem ainda usa a versão anterior.
• CNAB 240 e 400: remessa e retorno em arquivo.
• Boleto híbrido: na API V2, o QR Code Pix é gerado no registro do boleto.
• Pix: QR Code e copia e cola no boleto, na Central do Assinante e no Aplicativo do Cliente. Registro, consulta dos pagos e cancelamento são automáticos, com verificação a cada 8 minutos.
• Pix Automático: o assinante autoriza a recorrência uma vez, por QR Code gerado no cadastro dele, e as mensalidades seguintes são debitadas na data combinada.
• Débito automático: remessa e retorno no padrão de débito em conta, para assinantes com conta no Santander.

O que você precisa

• Conta no Santander com convênio de cobrança.
• Cadastro no Portal Developers do Santander e o convite do gerente para gerar as credenciais de emissão de boletos e de Pix.
• Certificado digital A1 da empresa, com a chave pública importada no cadastro do Santander. Também é possível usar o certificado parceiro entre Hubsoft e Santander.
• Uma chave Pix, de preferência aleatória, para o Pix e o boleto híbrido.
• Módulo Financeiro do Hubsoft, incluso na licença.

Como ativar

1. Em Configuração > Financeiro > Forma de Cobrança, crie a forma de cobrança com o Santander e homologue por remessa e retorno.
2. Faça o cadastro no Portal Developers e peça ao gerente o cadastro interno para gerar as credenciais.
3. Em Configuração > Geral > Certificado Digital, baixe a chave pública do certificado e importe no cadastro do Santander.
4. Na aba API da forma de cobrança, ative a transmissão e informe a versão v2, o certificado e as credenciais. Para o boleto híbrido, ative o Pix e informe a chave.
5. Cadastre a rotina Verifica Cobranças na API Bancária em Configuração > Geral > Rotinas.
6. Para o Pix e o Pix Automático, cadastre o Santander em Configuração > Integrações > PIX e vincule à forma de cobrança.

O passo a passo com as telas está na wiki da Hubsoft: boleto Santander, Pix Santander e débito automático Santander.

Limitações

• A API V1 faz só o registro. Para baixa, vencimento e retorno pela API, use a V2.
• Quando o certificado digital for renovado, a chave pública cadastrada precisa ser atualizada.
• O débito automático só debita contas do Santander e funciona só por remessa e retorno.
• O Pix Automático não aplica desconto até o vencimento: o valor autorizado é o valor cheio da fatura.

Perguntas frequentes

Qual a diferença entre o Pix separado e o boleto híbrido?

No Pix separado, o QR Code não fica registrado junto com o boleto, e o pagamento por Pix precisa gerar a baixa do boleto no banco. No híbrido, o Pix nasce no registro do boleto e o pagamento por qualquer meio quita o mesmo título.

Em quanto tempo o Pix pago aparece no Hubsoft?

O Hubsoft consulta os Pix pagos a cada 8 minutos.

O débito automático do Santander debita conta de outro banco?

Não. Para debitar em qualquer banco, use o Pix Automático.

Revisado em 10/10/2026.