Voltar para base de conhecimento

Como Configurar o PIX do Sicoob para Receber Direto na Conta da Empresa

Atualizado há cerca de 5 horas0 acharam útil
PixSicoobIntegraçãoRecebimentosCertificado Digital

Passo a passo para liberar a API Pix Recebimentos no portal Developers Sicoob, ativar o PIX do Sicoob no Berga e receber as cobranças PIX direto na conta da empresa, com baixa automática.

Para receber PIX pelo Sicoob no Berga, libere a API Pix Recebimentos na aplicação da empresa no portal Developers Sicoob e informe o Client ID e a chave PIX em Integrações › PIX Sicoob. As cobranças PIX da empresa passam a sair pelo Sicoob, o dinheiro cai direto na conta e o pagamento é baixado sozinho.

Abrir PIX Sicoob

Antes de começar

  • Conta Pessoa Jurídica no Sicoob, com acesso ao portal Developers Sicoob (developers.sicoob.com.br)
  • Chave PIX cadastrada nessa mesma conta (CNPJ, e-mail, celular ou chave aleatória). O Sicoob recusa a chave de outra conta, mesmo que seja da própria empresa
  • Certificado digital e-CNPJ A1 da empresa, válido. No Sicoob a aplicação não tem senha (client secret): o certificado é a segunda prova de identidade em toda comunicação

Se você já recebe boletos pelo Sicoob no Berga, pode aproveitar a mesma aplicação do portal: basta ela ter a API Pix Recebimentos.

Como liberar a API Pix Recebimentos no portal

  1. 1
    Entre em developers.sicoob.com.br e abra Meus aplicativos.
  2. 2
    Abra a aplicação da empresa (a mesma do boleto, se houver) ou crie uma nova.
  3. 3
    Inclua a API Pix Recebimentos com as permissões de cobrança, de PIX recebidos e de webhook.
  4. 4
    Copie o Client ID da aplicação.

Se o portal pedir o certificado ao criar a aplicação, envie o do mesmo e-CNPJ cadastrado no Berga.

Como conferir o certificado digital

  1. 1
    Acesse Configurações › Certificado Digital.
  2. 2
    Se ainda não houver certificado, envie o arquivo do e-CNPJ A1 (.pfx) e informe a senha.
  3. 3
    Confira se a validade aparece corretamente.

Se a empresa já emite nota fiscal ou boleto Sicoob pelo Berga, o certificado já está cadastrado: só confira a validade.

Como ativar o PIX do Sicoob no Berga

  1. 1
    Acesse Integrações › PIX Sicoob.
  2. 2
    Ative Receber PIX pelo Sicoob.
  3. 3
    Em Aplicação no portal Developers Sicoob, cole o Client ID (portal Developers Sicoob). Se o boleto do Sicoob já estiver configurado, clique em Usar a mesma aplicação do boleto.
  4. 4
    Em Recebimento, informe a Chave PIX da empresa.
  5. 5
    Clique em Salvar configurações.

Ao salvar, o Berga cadastra sozinho o aviso de pagamento (webhook) no Sicoob. O quadro de status no topo da tela testa as credenciais, o certificado digital, a conexão com o Sicoob e o aviso de pagamento. Com tudo em ordem, ele mostra Tudo certo.

Como o pagamento do PIX Sicoob é baixado

Com o aviso de pagamento ativo, o PIX pago é baixado segundos depois de o Sicoob avisar. Se o aviso não estiver cadastrado, o quadro de status mostra o botão Cadastrar no Sicoob.

Mesmo sem o aviso, o PIX pago não fica em aberto: o Berga confere as cobranças PIX pendentes no Sicoob a cada 2 minutos. Antes de dar baixa, o Berga sempre busca o valor e o horário do pagamento no próprio Sicoob.

Resultado esperado

As cobranças PIX saem com a sua empresa como recebedora, o dinheiro cai direto na conta do Sicoob e a cobrança é baixada automaticamente quando o cliente paga. Para voltar ao provedor PIX padrão, desative Receber PIX pelo Sicoob e salve.

Se der errado

O que apareceO que fazer
Status Credenciais com erroConfira se a integração está ativada e se o Client ID e a chave PIX foram informados
Status Conexão com o Sicoob com erroA aplicação não tem a API Pix Recebimentos ou o Client ID é de outra aplicação. Confira em Meus aplicativos no portal
Status Certificado digital com erro ou vencidoCadastre um e-CNPJ A1 válido em Configurações › Certificado Digital
Cobrança recusada com "O campo cob.chave corresponde a uma conta que não pertence a este usuário recebedor"A chave PIX é de outra conta. Use uma chave cadastrada na conta do Sicoob ligada à aplicação
Status Webhook de pagamento com erroClique em Cadastrar no Sicoob. Enquanto isso, a conferência a cada 2 minutos continua baixando os PIX pagos
PIX pago continua em abertoA conferência roda a cada 2 minutos. Se passar disso, abra o quadro de status e veja qual item está com erro

Artigos relacionados

Este artigo foi útil?