A integração direta do Pix com o Sicredi permite que o sistema se comunique com a API do banco para gerar o QR Code da cobrança durante a venda e receber a confirmação do pagamento de forma automática, sem conferência manual no extrato. Para que isso funcione, é necessário preparar o cadastro da conta bancária no sistema, solicitar a liberação do acesso à API no Portal Developer do Sicredi, gerar e validar os certificados digitais, vincular as credenciais ao cadastro e, por fim, criar a forma de pagamento que será usada na frente de caixa. Este guia percorre esse caminho na ordem em que ele deve ser executado.

Cadastro inicial da conta bancária

O primeiro passo é criar a conta bancária que receberá as cobranças Pix. Acesse Cadastros → Financeiro → Conta e clique em Cadastrar.

1. No campo Descrição, informe um nome que facilite a identificação da conta, como Pix Direto Sicredi.
2. No campo Banco, selecione o código 748 – Sicredi.
3. Mantenha a Situação como Ativa e informe o Tipo de Conta.
4. Preencha Número Agência, Dígito Agência, Número Conta e Dígito Conta. Esses campos não são exigidos pela integração, mas o preenchimento é recomendado para manter o cadastro organizado.
5. Localize o campo Integração pix? e selecione Sim. O sistema passa a exibir os campos necessários para a comunicação direta com a API do banco.

Deixe esse cadastro em aberto ou salve-o para retomar depois, porque os campos de certificado e credenciais só serão preenchidos após a liberação do acesso pelo Sicredi.

Liberação do acesso no Portal Developer do Sicredi

As credenciais de integração não são geradas pelo sistema: elas vêm do próprio banco, e o cliente precisa ter um cadastro ativo no Portal Developer do Sicredi para solicitá-las.

Antes de abrir o chamado, o cliente deve solicitar a adesão à API Pix diretamente na sua cooperativa e assinar o termo correspondente. A confirmação chega por e-mail e traz o ID de adesão, que é obrigatório para a solicitação.

1. Faça login no Portal Developer do Sicredi.
2. Acesse a opção de suporte e abra um chamado.
3. Selecione a opção de acesso à API de Pix.
4. Informe o CNPJ e o ID de adesão do cliente.
5. Acompanhe o andamento em suporte → meus chamados.

Geração e validação dos certificados

Com o acesso aprovado, o próximo passo é gerar o certificado que autentica a empresa junto à API do banco. No portal do Sicredi, acesse APIs → Catálogo de APIs → APIs de Recebimento Pix → Certificados e Credenciais e clique em Registrar novo CSR.

1. Preencha as informações solicitadas e gere a requisição.
2. Salve todos os arquivos disponibilizados em uma mesma pasta, separando a chave com senha da chave sem senha para evitar confusão na hora do envio.
3. Acompanhe o status do certificado em APIs de Recebimento Pix.
4. Quando o status estiver como OK, abra o menu de três pontos do certificado e faça o download do certificado validado e da cadeia completa do Sicredi, salvando-os na mesma pasta.
5. Ainda no portal, gere as credenciais para o ambiente de produção. O portal exibirá o Client ID e o Client Secret.

Guarde o Client ID e o Client Secret em local seguro assim que forem exibidos, pois em geral não é possível consultá-los novamente depois.

Vinculação das credenciais e criação da forma de pagamento

Retorne ao cadastro da conta bancária em Cadastros → Financeiro → Conta e conclua o preenchimento com os arquivos e as credenciais obtidos no portal.

1. Selecione os arquivos de certificado da empresa nos campos correspondentes ao formato de cada um.
2. Preencha o Client ID e o Client Secret gerados no portal.
3. Informe o Tipo de Chave Pix e a Chave Pix cadastrada para a empresa, que pode ser CPF/CNPJ, e-mail, celular ou chave aleatória. Confirme que a chave utilizada está vinculada ao CNPJ da empresa.
4. Preencha o Usuário portal developer e a Senha portal developer.
5. Clique em Salvar.

Com a conta configurada, acesse Cadastros → Financeiro → Forma de Pagamento e clique em Cadastrar para criar a forma que será usada no caixa. Informe uma Descrição que identifique o Pix integrado, selecione no campo Tipo a opção 17 – Pagamento Instantâneo (Pix), ative a Integração QRCode Pix e, no campo Conta, selecione a conta bancária configurada nos passos anteriores. Salve o cadastro.

Teste prático na frente de caixa

Com tudo configurado, o fluxo de venda passa a funcionar de ponta a ponta. Na frente de caixa, lance os produtos normalmente e selecione a forma de pagamento criada para o Pix integrado. O sistema envia a solicitação de cobrança para a API do banco e exibe o QR Code Pix com o valor total da venda em poucos segundos.

A tela do PDV permanece bloqueada até que o pagamento seja detectado ou até a expiração do prazo do Pix. Nesse intervalo, o cliente escaneia o código pelo aplicativo do banco e realiza o pagamento. Quando o banco confirma a transação, o retorno chega automaticamente ao sistema, que registra o pagamento na venda e libera a finalização da operação de caixa.

Em ambiente de homologação, a confirmação automática pode demorar ou não ser enviada pelo banco em alguns casos. Se isso acontecer, clique no botão Consultar disponível na tela para verificar o status diretamente na API e atualizar o pagamento. Em produção, a confirmação ocorre sempre de forma automática. Vale reforçar com a equipe que, uma vez confirmado, o pagamento via Pix não pode ser cancelado ou alterado no PDV.