Artigos sobre: Integrações

Como fazer integração com a API do SICOOB para geração de cobranças

Visão geral

O GDASH permite a integração direta com o Banco SICOOB para emissão automática de cobranças e boletos via API.

Antes de gerar cobranças, é necessário configurar as credenciais de autenticação do Sicoob no painel do GDASH.


Atenção! Esta integração possui uma cobrança adicional de R$2,49 por boleto compensado. O valor total será apurado no encerramento de cada ciclo de faturamento da sua assinatura e adicionado automaticamente à sua próxima fatura. Outras taxas eventualmente aplicadas deverão ser consultadas diretamente com o banco ou instituição financeira provedora da API de integração.



  1. Para realizara integração, clique em Integrações no menu lateral a esquerda, em seguida em Cobranças e no cartão do SICOOB:


🧩 Autenticação com o SICOOB

A autenticação é o primeiro passo do processo de integração.

O SICOOB exige o uso de certificados digitais e credenciais válidas para garantir a segurança da comunicação com sua API.


São necessários cinco elementos principais:


  1. Chave privada (.key)
  2. Certificado público (.cer ou .pem)
  3. Client ID
  • Identificador único gerado no portal do desenvolvedor do SICOOB.
  • Obtido ao criar uma integração no Portal de Desenvolvedores SICOOB.
  1. Número da conta corrente
  2. Número do cliente.
  • Caso não tenha o número de cliente anotado, essa informação pode ser obtida através do seu gerente SICOOB.


Como extrair a chave privada e o certificado público

Para extrair a chave privada e o certificado público através de um certificado digital, o SICOOB disponibiliza um passo a passo no artigo a seguir:


Artigo de como exportar o certificado para gerar o aplicativo


Para ajudar no passo a passo do prompt de comando, no exemplo abaixo, o certificado digital foi nomeado como CERTIFICADO.pfx



Segue abaixo os prompts de comando para cada arquivo:


Certificado público (.cer ou .pem)

openssl pkcs12 -in certCERTIFICADO.pfx -nokeys -out certCERTIFICADO.pem


Chave privada (.key)

openssl pkcs12 -in cert/CERTIFICADO.pfx -nocerts -nodes -out cert/CERTIFICADO_PRIVADA.key


O nome do arquivo do certificado digital, deve estar igual nos prompts para que seja criado o arquivo com sucesso.


O resultado será os arquivos abaixo:

Como criar o client ID

  1. Crie uma conta no Portal de Desenvolvedores SICOOB.
  2. Após a conta criada clique em Meus aplicativos
  3. Clique em Cadastrar novo aplicativo


  1. Faça o login com sua conta do SICOOB
  2. Coloque o nome do aplicativo como GDASH e uma breve descrição

  1. Insira o certificado digital de sua empresa e clique em prosseguir


  1. Selecione as permissões, de acordo com a imagem abaixo:


  1. Confirme os dados e clique em criar aplicativo
  2. Depois do aplicativo criado, vá em Meus Aplicativos e clique no cartão do GDASH
  3. O client id estará disponível:




Pronto, com posse de todos os arquivos, basta inseri-los no card do SICOOB no GDASH e finalizar a integração.


Dúvidas ou problemas? Fale com nosso suporte clicando aqui!


Atualizado em: 17/11/2025

Este artigo foi útil?

Compartilhe seu feedback

Cancelar

Obrigado!