Como Configurar o PIX do Sicoob para Receber Direto na Conta da Empresa
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.
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
- 1Entre em developers.sicoob.com.br e abra Meus aplicativos.
- 2Abra a aplicação da empresa (a mesma do boleto, se houver) ou crie uma nova.
- 3Inclua a API Pix Recebimentos com as permissões de cobrança, de PIX recebidos e de webhook.
- 4Copie 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
- 1Acesse Configurações › Certificado Digital.
- 2Se ainda não houver certificado, envie o arquivo do e-CNPJ A1 (.pfx) e informe a senha.
- 3Confira 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
- 1Acesse Integrações › PIX Sicoob.
- 2Ative Receber PIX pelo Sicoob.
- 3Em 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.
- 4Em Recebimento, informe a Chave PIX da empresa.
- 5Clique 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 aparece | O que fazer |
|---|---|
| Status Credenciais com erro | Confira se a integração está ativada e se o Client ID e a chave PIX foram informados |
| Status Conexão com o Sicoob com erro | A 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 vencido | Cadastre 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 erro | Clique em Cadastrar no Sicoob. Enquanto isso, a conferência a cada 2 minutos continua baixando os PIX pagos |
| PIX pago continua em aberto | A conferência roda a cada 2 minutos. Se passar disso, abra o quadro de status e veja qual item está com erro |