Pix Sicoob

O Fácil123 emite dois tipos de Pix pelo Sicoob usando a API de Cobrança do banco:

• Pix com vencimento: tem data de vencimento e aceita juros e multa após o vencimento.
• Pix instantâneo: valor fixo, sem vencimento. Expira em 15 minutos a partir da emissão.

Configurada a integração, cada cobrança Pix criada em uma venda ou em um lançamento financeiro é registrada no Sicoob e, quando paga, tem o recebimento baixado automaticamente — sem precisar lançar nada no internet banking. A mesma Conexão com API, Chave Pix e aplicação no Portal Developers atendem aos dois tipos — não é preciso configurar duas vezes.

A integração com Pix requer uma aplicação separada no Portal Developers-Sicoob. Mesmo que você já tenha feito a integração com boleto, será necessário criar uma nova aplicação — desta vez selecionando o produto Pix recebimentos.

Passo a passo

No Fácil123

Se você já fez a integração com boleto, pode pular os passos 1 e 2.

1. Vá em Financeiro → Contas → Incluir → escolha o Sicoob → adicione o nome da conta como Conta Sicoob.
2. Selecione as opções que deseja habilitar → digite o banco, agência, conta e DV → Salvar.
3. Vá em Engrenagem → Conexão com API → Incluir → coloque o Nome como Sicoob → no Emissor selecione Sicoob V3.
4. Em Certificado coloque o seu certificado digital → informe a Senha do certificado.
5. Clique em Baixar chave pública (aparecerá em laranja) — você usará esse arquivo no Portal Developers-Sicoob → Salvar.

No Portal Developers-Sicoob

IMPORTANTE: Você tem 5 minutos para se conectar no Internet Banking e finalizar a autorização. Caso não seja realizado nesse tempo, é preciso iniciar novamente mais tarde.

1. Acesse o Portal Developers-Sicoob. Se já é cadastrado clique em Entrar, caso contrário vá em Cadastro.
2. Após estar logado vá em Meus aplicativos → Cadastrar novo aplicativo → Ok, continuar. O Sicoob irá redirecionar para o login — use seu usuário e senha do App Sicoob.
3. Informe a Cooperativa, Chave de Acesso e Senha → preencha o código de verificação enviado para o seu app → Autorizar.
4. Em Nome do aplicativo coloque Fácil123 API → em Descrição do aplicativo coloque ERP → Prosseguir.
5. Em A integração será por uma empresa parceira? selecione Não → em Certificado digital coloque a chave pública que baixou no Fácil123 → Prosseguir.
6. Selecione Pix recebimentos → Prosseguir → Criar aplicativo.
7. Clique em Ir para Meus Aplicativos → clique na aplicação API Fácil123 (status: pendente).

No Sicoobnet Empresarial

1. Acesse o ícone de pesquisa → procure por Transações Pendentes / Detalhamento → Autorização para Uso de APIs.
2. Insira sua senha e autorize.

No Portal Developers-Sicoob (continuação)

1. Clique no aplicativo API Fácil123 que agora está ativo.
2. Copie o código Client ID — você usará ele no próximo passo.

No Fácil123 (continuação)

1. Vá em Engrenagem → Conexão com API → selecione a conexão Sicoob → Alterar → coloque o Client ID no seu campo → Salvar.
2. Vá em Financeiro → Contas → Incluir → escolha o Sicoob → adicione o nome da conta como Pix Sicoob → em conta bancária digite o banco, agência, conta e DV.
3. Habilite as opções de Pix que deseja usar:
   • Permitir cobrança por Pix com vencimento — para Pix com data, juros e multa.
   • Permitir cobrança por Pix instantâneo — para Pix de valor fixo com expiração em 15 minutos.
4. Na Conta Pix selecione Sicoob (API V2) → em Conexão com API selecione Sicoob pix → em Chave Pix cole a chave pix aleatória gerada no Sicoob.
5. Clique em Salvar.

Você pode habilitar os dois tipos na mesma conta — a configuração de Conta Pix é compartilhada entre eles.

Configurando os meios de pagamento

Para cada tipo de Pix habilitado na conta, cadastre o meio de pagamento correspondente.

• Pix com vencimento: vá no menu Vendas → Meio de pagamento → clique em Pix → Alterar → no Nome coloque Pix Sicoob → no Método de Pagto selecione Pix com vencimento → em Conta escolha Conta do Sicoob → em NF-e / NFC-e selecione Pagamento Instantâneo (PIX) - Dinâmico → Salvar.
• Pix instantâneo: mesmo caminho, mas no Método de Pagto selecione Pix instantâneo → em Conta escolha Conta do Sicoob → em NF-e / NFC-e selecione Pagamento Instantâneo (PIX) - Dinâmico → Salvar.

Você pode manter os dois cadastrados ao mesmo tempo. O sistema oferecerá o tipo correto no momento de gerar a cobrança, conforme o meio de pagamento escolhido na parcela.

Prontinho! Você já pode emitir Pix com vencimento e Pix instantâneo pelo Sicoob no Fácil123.

Caso ocorram erros na emissão, avise o suporte o quanto antes para verificarmos.

Perguntas e respostas

1 - Preciso criar uma nova aplicação ou outra Chave Pix para o Pix instantâneo?
R: Não. A mesma aplicação no Portal Developers-Sicoob, a mesma Conexão com API e a mesma Chave Pix atendem aos dois tipos de Pix. Basta habilitar a opção Permitir cobrança por Pix instantâneo na Conta e criar o meio de pagamento correspondente.

2 - O Pix instantâneo pode ser pago depois dos 15 minutos?
R: Não. Passado o tempo de expiração, o QRcode deixa de ser válido. Se o cliente perder o prazo, basta gerar uma nova cobrança.

3 - Consigo emitir Pix instantâneo para um cliente sem CPF ou CNPJ no cadastro?
R: Sim. Diferentemente do boleto, o Pix instantâneo pode ser emitido para "consumidor final" — quando a transação não tem CPF/CNPJ, o sistema omite os dados do devedor na cobrança e a emissão acontece normalmente.

4 - Meu cliente pagou o Pix mas a parcela não baixou automaticamente. O que fazer?
R: Confira se a Conexão com API do Sicoob não expirou e se o certificado digital vinculado a ela não está vencido. Qualquer um dos dois problemas interrompe a comunicação com o banco, fazendo com que cobranças já pagas deixem de ser identificadas automaticamente. Veja como renovar o certificado em Atualizando o certificado da integração.