Cobrança Santander: o que configurar

Atualizado em 30 de agosto de 2026

O que o Santander pede na tela Financeiro → Carteiras → + Nova, depois de escolher o provedor Santander.

Obrigatórios

Client ID — texto
Client Secret — senha (fica cifrada)
Certificado (.crt/.pem) — arquivo
Chave privada (.key) — arquivo
Workspace ID — texto
Convênio (7 dígitos) — texto
Ambiente — escolha

Tem dois identificadores que confundem: o Workspace ID (do portal do desenvolvedor) e o Convênio de 7 dígitos (do contrato de cobrança). São coisas diferentes e os dois são obrigatórios.

Abaixo das credenciais vem o bloco de parametrização da cobrança (multa, juros, desconto, protesto, instruções), igual para todos os bancos de boleto registrado — está descrito no artigo Multa, juros, desconto e protesto: o bloco comum a todos os bancos.

Cada campo tem um ⓘ com a dica do que é. Senhas e certificados são gravados cifrados e nunca voltam para a tela.

Comece em HOMOLOGAÇÃO. Os boletos gerados ali não têm valor e servem para conferir que as credenciais estão certas. Só depois vire para PRODUÇÃO.

Formulário de carteira com o provedor Santander selecionado, mostrando os campos que ele pede

A ação ao vivo: escolher Santander e ver os campos que aparecem.