A integração Pix Direto com o Sicoob permite gerar cobranças por QR Code no momento da venda e receber automaticamente a confirmação do pagamento no sistema. Para que o processo funcione corretamente, é necessário configurar a conta bancária, cadastrar uma aplicação no portal Developer do Sicoob, informar as credenciais no sistema e vincular a conta a uma forma de pagamento Pix.

1. Configuração da conta bancária

A primeira etapa consiste em cadastrar ou ajustar a conta bancária que será utilizada na integração. Acesse o menu Financeiro do sistema e entre na opção de cadastro de contas bancárias.

Preencha uma descrição que facilite a identificação da conta, como Pix Direto Sicoob, e selecione o banco 756 – Sicoob no campo correspondente.

Os dados de agência, número da conta e dígitos verificadores podem ser informados para manter o cadastro completo e organizado. Entretanto, esses campos são opcionais para este tipo de integração.

Para habilitar os campos de comunicação com o banco, realize a configuração abaixo:

1. Localize o campo de integração com Pix.
2. Altere a opção para Sim.
3. Confirme se os campos de certificado, senha, Client ID e chave Pix foram exibidos.

Esses dados serão preenchidos após a criação da aplicação no portal do Sicoob.

2. Cadastro da aplicação no portal Developer do Sicoob

O titular da conta corrente deve possuir um cadastro ativo no portal Developer do Sicoob. O acesso deve ser realizado utilizando o CPF ou CNPJ vinculado à conta que será integrada.

Após entrar no portal, acesse a opção Gerar aplicativo. Durante a validação, utilize o mesmo usuário e a mesma senha do aplicativo Sicoob Mobile Banking para confirmar a titularidade da conta corrente.

No cadastro da aplicação, informe:

• Nome da aplicação, como Integração Pix;
• Conta corrente que será utilizada;
• Nome do cooperado;
• Breve descrição da finalidade da aplicação;
• Certificado digital A1 da empresa, nos formatos PFX ou P12.

Na seleção das APIs, marque a opção correspondente ao Pix. Em seguida, revise os dados informados e clique em Criar aplicativo.

Após a conclusão, o portal disponibilizará as credenciais necessárias para a integração, incluindo o Client ID.

3. Configuração das credenciais no sistema

Com a aplicação criada, retorne ao cadastro da conta bancária no sistema para informar as credenciais fornecidas pelo Sicoob.

Preencha os campos da integração seguindo esta sequência:

1. Selecione o certificado digital A1 da empresa no formato PFX.
2. Informe a senha do certificado digital.
3. Preencha o Client ID gerado no portal Developer do Sicoob.
4. Informe a chave Pix vinculada à empresa.
5. Clique em Salvar.

A chave Pix pode ser do tipo CNPJ, CPF, e-mail, telefone ou chave aleatória. Ela deve estar cadastrada na mesma conta bancária utilizada na aplicação do Sicoob.

Após salvar, a conta estará configurada para realizar a comunicação direta com a API Pix do banco.

4. Vinculação com a forma de pagamento

Para utilizar a integração no caixa, a conta bancária deve ser vinculada a uma forma de pagamento do tipo Pix.

Acesse o menu Cadastros Financeiros e entre na opção Formas de pagamento. Crie um novo cadastro ou edite uma forma de pagamento existente.

Realize as seguintes configurações:

1. Informe uma descrição clara, como Pix Direto Sicoob.
2. Selecione Pix Dinâminco no campo de tipo da forma de pagamento.
3. Marque Sim na opção de integração com QR Code Pix.
4. Selecione a conta bancária configurada anteriormente.
5. Clique em Salvar.

A forma de pagamento ficará disponível para utilização nas vendas realizadas pelo caixa.

5. Teste da integração no caixa

Para validar o funcionamento, abra a tela de vendas do caixa, adicione um produto e avance para a finalização da venda.

Selecione a forma de pagamento Pix Direto Sicoob. O sistema enviará a cobrança para a API do banco e, após o processamento, exibirá o QR Code Pix na tela do PDV.

O fluxo de pagamento ocorrerá da seguinte maneira:

1. O cliente escaneia o QR Code utilizando o aplicativo financeiro de sua preferência.
2. O cliente confirma o pagamento.
3. O Sicoob processa a transação.
4. O sistema recebe automaticamente a confirmação do banco.
5. O pagamento é registrado e a venda é liberada para finalização.

Em ambiente de homologação, o retorno automático pode apresentar demora. Nessa situação, utilize o botão Consultar para verificar manualmente o status da cobrança na API.

Em ambiente de produção, a confirmação do pagamento normalmente ocorre de forma automática, sem necessidade de consulta manual.