Skip to main content

Guia de Integração | Sicoob PIX

sgptsmx-petroleo.png

1. Introdução

A integração com APIs PIX para a emissão de cobranças representa um avanço estratégico para empresas que buscam automatizar e otimizar sua gestão financeira. Ao conectar diretamente o SGP às instituições bancárias, elimina-se a necessidade de processos manuais, como conciliações demoradas e verificações externas, garantindo agilidade e precisão na liquidação dos pagamentos.

Entre os principais benefícios dessa integração, destacam-se:

  • Automatização do processo de cobrança: o QR Code PIX é gerado e registrado automaticamente a partir do SGP, atendendo às regras do Banco Central e garantindo maior agilidade no processo.

  • Retornos instantâneos ou em até 15 minutos: a confirmação do pagamento ocorre em tempo real (ou no máximo em 15 minutos, conforme regulamentação do BACEN), permitindo atualização imediata dos recebimentos no sistema.

  • Redução de erros e inconsistências: a comunicação direta evita falhas comuns em processos manuais, como atrasos no reconhecimento de pagamentos ou divergências de valores.

  • Maior segurança e confiabilidade: os dados são transmitidos de forma padronizada e segura, reduzindo riscos de fraudes ou informações incorretas.

  • Controle centralizado: todas as movimentações financeiras ficam registradas no SGP, facilitando a conciliação e o acompanhamento da inadimplência.

Assim, a integração PIX via API não apenas simplifica o processo de cobrança, como também garante retornos rápidos, maior eficiência operacional, segurança e controle estratégico sobre o fluxo de caixa da organização.

Antes de iniciar o processo, consulte nossa FAQ – Atenção à Segurança da sua Integração! para garantir uma implementação mais segura e eficiente.

2. Dados necessários para integrar ao SGP

Para realizar a integração da API PIX do Sicoob, é necessário inicialmente gerar as credenciais de acesso no portal do desenvolvedor Sicoob.

As credenciais usadas para integração devem geradas com auxilio do suporte do banco.

Durante esse processo, serão exigidos alguns dados e arquivos obrigatórios:

  • Client ID

  • Chave PIX

  • Certificado + Senha

Atenção ao Certificado:
O certificado utilizado no SGP é o Certificado Digital A1 (Privado).

3. Cadastro do Gateway PIX

Com os dados em mãos, podemos integrar o Gateway ao SGP para emissão de PIX.

  • No Menu Principal, acesse Financeiro (❶), depois vá em Cadastros (❷) e, em seguida, clique em Gateway de Pagamento (❸).

Modelo_de_imagem_horizontal_com_sombra.png

Esse modelo de integração é apenas para emissão de QRCode PIX, caso queira uma integração de Boleto Hibrido, verifique a documentação correspondente!

Clique no botão Cadastrar e preencha da seguinte forma:

  1. Nome da Integração: Sicoob API Pix
  2. Descrição
  3. Usuário: Client ID
  4. Chave PIX
  5. Habilite Pagamentos via PIX
  6. Selecione o Portador criado para emissão do PIX
  7. URL Notificação: https://url_do_seu_sgp/ws/notificacao/pix
  8. Inserir o Certificado com extensão .PFX e sua senha
Imagem de Referência (API PIX)

Captura de tela_8-10-2025_111424_sistema.sgp.net.br.jpeg

4. Informações Adicionais
  • A URL de notificação deve obrigatoriamente utilizar o protocolo HTTPS. Caso ainda não possua um endereço com HTTPS, entre em contato com o suporte para verificar a possibilidade de aquisição de um subdomínio SGP.
  • No cadastro da URL de notificação, o ID do Gateway é indispensável para o correto processamento dos retornos.
    • Para identificá-lo, siga os passos:
      • Crie um gateway deixando o campo “URL de notificação” em branco.
      • Anote o ID gerado.
      • Em seguida, cadastre a URL de notificação utilizando esse ID.
  • Para integrações que exijam uma rotina de processamento de retorno, é necessário acionar o suporte para que seja feita a configuração dessa rotina.
  • A integração do PIX Avulso pode ser vinculada a portadores locais ou portadores outros bancos que não tenham emissão de pix.

  • A seguir, listamos algumas funcionalidades disponíveis para a sua integração:

Funcionalidade Sicoob API PIX
PIX - Emissão ✔️
PIX - Cancelamento ✔️
PIX - Tempo de Baixa Rotina/Webhook
Parâmetros forcar_atualizacao_pix, pixvencimento=1
É cov ou cobv? ambos
PIX Híbrido ou Avulso? Avulso
Possíveis Alterações Não há

 

Para essa integração existem dois tipos de PIX o  Pix Cob e Pix CobV  :

  •  Sendo possivel usar o parâmetro abaixo para gerar um novo pix atualizado após expirar. 
    forcar_atualizacao_pix=1

  •  Pix CobV (Cobrança com Vencimento) : Permite definir uma data de vencimento e aplicar juros, multas e descontos. Usado para cobranças recorrentes, como boletos. Nessa modalidade, no SGP o PIX acompanha o "vencimento" do boleto atualizando Multa e Juros diários. Pode ser habilitado com o uso do seguinte parâmetro:

    pixvencimento=1

Para usar os parâmetros acima é preciso verificar com o banco quais escopos estão ativos para a sua conta.

tsmx-petroleo.png


Back to top