ajuda

Cobrança Banrisul (Cobrança v1): o que configurar

Atualizado em 30 de agosto de 2026

O que o Banrisul (Cobrança v1) pede na tela Financeiro → Carteiras → + Nova, depois de escolher o provedor Banrisul (Cobrança v1).

Obrigatórios

  • Client ID — texto
  • Client Secret — senha (fica cifrada)
  • Beneficiário/convênio (13 díg.) — texto
  • Ambiente — escolha

Opcionais

  • Espécie do título (cód.) — texto
  • URL do token OAuth (avançado) — texto
  • Certificado (.pem, se mTLS) — arquivo
  • Chave privada (.key, se mTLS) — arquivo

O certificado é condicional: só entra se o seu contrato exigir mTLS. A URL do token é campo avançado — deixe vazio salvo se o banco te passar uma diferente.

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 Banrisul (Cobrança v1) selecionado, mostrando os campos que ele pede

A ação ao vivo: escolher Banrisul (Cobrança v1) e ver os campos que aparecem.