2023-09-28-14-33-33-Manual de Recebimento Pix SICREDI Utilizado No Vendas PDV

---
title: Configuração do Recebimento Pix Sicredi no Vendas PDV
slug: 2023-09-28-14-33-33
sistema:
  - Teorema Pay
chamado: "0000441426"
categoria: user_manual
tipo: how-to
autor: ""
setor: Qualidade
modulo: ""
publico: "Técnicos de implantação e suporte"
keywords:
  - Pix
  - Sicredi
  - OpenSSL
  - certificado
  - API PIX
  - Vendas PDV
  - QR Code
versao_doc: 03
revisao: ""
aprovado_em: ""
release: D 23.05a
versao_pipeline: 2.7.0
ultima_revisao: "2026-06-13"
---

## Visão Geral

Configura a integração da API Pix do Sicredi no Vendas PDV. O processo envolve quatro etapas sequenciais: instalação e configuração do OpenSSL para geração de chaves criptográficas, envio do certificado CSR (Certificate Signing Request) ao banco para obtenção dos certificados válidos, configuração da conta no Gestão Administrativo, e uso do pagamento Pix no fechamento de vendas no Balcão PDV.

> **Pré-requisito:** Acesso ao Internet Banking do Sicredi com permissão para gerenciar certificados na opção Acesso API PIX. A agência do Sicredi deve fornecer as informações necessárias para preenchimento do certificado CSR (Country, State, Locality, Organization, etc.).

## Instalar e Configurar o OpenSSL

O OpenSSL é necessário para gerar as chaves criptográficas exigidas pela API PIX do Sicredi.

**1.1 — Baixar o instalador**

Acesse [https://slproweb.com/products/Win32OpenSSL.html](https://slproweb.com/products/Win32OpenSSL.html) e faça o download do instalador Win32/Win64 OpenSSL.

![Página de download do Win32 OpenSSL com tabela de versões disponíveis para download](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-01.png)

**1.2 — Instalar e abrir as variáveis de ambiente**

Execute a instalação padrão. Em seguida, abra a pesquisa do Windows, digite `varia` e selecione **Editar as variáveis de ambiente do sistema** no Painel de Controle.

![Menu Iniciar do Windows com resultado de busca "varia" destacando a opção "Editar as variáveis de ambiente do sistema"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-02.png)

**1.3 — Abrir Variáveis de Ambiente**

Na janela Propriedades do Sistema, aba **Avançado**, clique em **Variáveis de Ambiente**.

![Janela Propriedades do Sistema com abas Nome do Computador, Hardware, Avançado, Proteção do Sistema e Remoto; botão Variáveis de Ambiente destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-03.png)

**1.4 — Editar a variável PATH**

Na janela Variáveis de Ambiente, selecione a variável **Path** na seção "Variáveis de usuário" e clique em **Editar**.

![Janela Variáveis de Ambiente com variáveis de usuário (MOZ_PLUGIN_PATH, OneDrive, Path, TEMP, TMP) e variáveis do sistema; variável Path do usuário selecionada e botão Editar destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-04.png)

**1.5 — Adicionar o caminho via Procurar**

Na janela de edição da variável de ambiente, clique em **Procurar** para localizar a pasta de instalação do OpenSSL.

![Janela Editar a variável de ambiente com entradas existentes e botão Procurar destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-05.png)

**1.6 — Selecionar a pasta bin do OpenSSL**

Navegue até `C:\Program Files\OpenSSL-Win64\bin` (para versão 64 bits), selecione a pasta **bin** e clique em **OK**.

![Janela Procurar Pasta com estrutura de diretórios mostrando OpenSSL-Win64 expandido com subpasta bin selecionada](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-06.png)

**1.7 — Confirmar o caminho**

O caminho `C:\Program Files\OpenSSL-Win64\bin` será adicionado à lista. Clique em **OK** para confirmar.

![Janela Editar a variável de ambiente com entrada C:\Program Files\OpenSSL-Win64\bin adicionada e destacada na lista; botão OK destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-07.png)

**1.8 — Finalizar e reiniciar**

Clique em **OK** na janela Variáveis de Ambiente e reinicie a máquina para que as alterações sejam aplicadas.

![Janela Variáveis de Ambiente com variável Path do usuário atualizada; botão OK destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-08.png)

## Gerar as Chaves com o OpenSSL

**2.1 — Criar a pasta de certificados**

Crie a pasta `c:\teorema\certificados` para armazenar os arquivos gerados.

![Windows Explorer mostrando o diretório C:\teorema com a pasta certificados criada em 27/09/2023](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-09.png)

**2.2 — Abrir o Prompt de Comando**

Abra a pesquisa do Windows, digite `prom` e abra o **Prompt de Comando**.

![Menu Iniciar com resultado de busca "prom" exibindo Prompt de Comando como melhor correspondência](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-10.png)

**2.3 — Navegar até a pasta de certificados**

No Prompt de Comando, execute:

```
cd c:\teorema\certificados
```

![Prompt de Comando com o comando cd c:\teorema\certificados executado e prompt exibindo c:\teorema\certificados>](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-11.png)

**2.4 — Gerar o arquivo de chave (.key) — Primeiro Passo do Sicredi**

Execute o seguinte comando para gerar o arquivo de chave privada:

```
openssl genrsa -des3 -out APLICACAO.key 2048
```

O OpenSSL solicitará uma frase secreta (`Enter PEM pass phrase` / `Verifying - Enter PEM pass phrase`). Digite e confirme a senha — o cursor não se move durante a digitação. Anote a senha pois ela será usada nos passos seguintes.

> **Nota:** O Sicredi recomenda: algoritmo RSA (genrsa), tamanho de chave 2048 bits ou mais, criptografia AES256 ou Triple DES (-aes256 ou -des3).

![Prompt de Comando com o comando openssl genrsa -des3 -out APLICACAO.key 2048 executado e solicitação da frase secreta; ao lado, documento Sicredi descrevendo o Primeiro Passo — Gerar o arquivo de chave (.key) com recomendações de algoritmo RSA, tamanho 2048 e criptografia AES256 ou Triple DES](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-12.png)

**2.5 — Gerar o certificado CSR — Segundo Passo do Sicredi**

Execute o comando para gerar o CSR. As informações solicitadas (Country Name, State, Locality, Organization, etc.) devem ser fornecidas pela agência do Sicredi e preenchidas exatamente como informado, respeitando maiúsculas e minúsculas. Informe um e-mail cadastrado na conta do Sicredi.

![Prompt de Comando com a execução do comando openssl para geração do certificado CSR com campos Country Name (BR), State (Rio Grande do Sul), Locality, Organization Name (MPI Sicredi), Organizational Unit (MPI Sicredi), Common Name, e Email Address; ao lado, documento Sicredi com o Segundo Passo — Gerar a requisição do certificado CSR](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-13.png)

**2.6 — Retirar a frase secreta da chave — Terceiro Passo do Sicredi**

Execute os dois comandos abaixo para gerar a chave RSA sem frase secreta (necessária para envio ao banco):

```
move APLICACAO.key APLICACAO_COMSENHA.key
openssl rsa -in APLICACAO_COMSENHA.key -out APLICACAO.key
```

Quando solicitado `Enter pass phrase for APLICACAO_COMSENHA.key`, informe a senha definida no passo anterior.

![Prompt de Comando com os comandos move APLICACAO.key APLICACAO_COMSENHA.key e openssl rsa -in APLICACAO_COMSENHA.key -out APLICACAO.key executados, com saída "writing RSA key"; ao lado, documento Sicredi com o Terceiro Passo — Retirando a frase secreta](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-14.png)

**2.7 — Verificar os arquivos gerados**

Na pasta `c:\teorema\certificados` devem estar presentes três arquivos: `APLICACAO.csr`, `APLICACAO.key` e `APLICACAO_COMSENHA.key`. O arquivo `APLICACAO.csr` é o que será enviado ao Sicredi.

![Windows Explorer mostrando a pasta C:\teorema\certificados com os arquivos APLICACAO.csr (Arquivo CSR, 2 KB), APLICACAO.key (Arquivo KEY, 2 KB) e APLICACAO_COMSENHA.key (Arquivo KEY, 2 KB)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-15.png)

> **Nota:** Após o cliente vincular o arquivo na conta, o banco leva até 3 dias úteis para liberar os certificados válidos.

## Enviar o Certificado ao Banco Sicredi

**3.1 — Acessar Outros Serviços no Internet Banking**

Solicite ao cliente que acesse o Internet Banking do Sicredi e clique em **Outros Serviços** no menu superior.

![Internet Banking do Sicredi com menu de navegação superior contendo Página Inicial, Conta Corrente, Capital Social, Pagamentos, Cartões, Transferências, Pix, DDA/Agenda de Boletos, Investimentos, Cobrança, Autorizações, Agente Credenciado, Shopping, Crédito, Folha de Pagamento, Pagamento a Fornecedores, Custódia de Cheques; opção Outros Serviços destacada no menu lateral](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-16.png)

**3.2 — Acessar Gerenciar Certificados**

No menu lateral, em **Acesso API PIX**, selecione **Gerenciar Certificados**.

![Menu lateral do Internet Banking Sicredi com seção Acesso API PIX contendo as opções Gerenciar Certificados e Gerar Credenciais; opção Gerenciar Certificados destacada com seta](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-17.png)

**3.3 — Enviar o arquivo APLICACAO.csr**

Na tela Gerenciar Certificados, clique em **procure no dispositivo** e localize o arquivo `APLICACAO.csr` gerado na pasta `c:\teorema\certificados`.

![Tela Gerenciar Certificados do Internet Banking Sicredi com wizard de três etapas (Informar Dados, Confirmar Dados, Comprovante); área de envio de certificado com opção "procure no dispositivo" e botão Enviar certificado desabilitado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-18.png)

**3.4 — Confirmar o envio**

Após selecionar o arquivo `APLICACAO.csr`, clique em **Enviar Certificado** e, na tela seguinte, clique em **Confirmar**.

![Tela Gerenciar Certificados com arquivo APLICACAO.csr selecionado e botão Enviar certificado habilitado; ao lado, tela Envio de certificado digital na etapa Confirmar Dados com campos CPF/CNPJ e Certificado digital preenchidos e botão Confirmar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-19.png)

**3.5 — Aguardar confirmação**

A tela exibirá a mensagem **"Certificado enviado com sucesso."** seguida de aviso de que o certificado digital estará disponível para download em até 3 dias úteis. Acompanhe o retorno em "Gerenciar certificado".

![Tela de comprovante do Internet Banking Sicredi com mensagem "Certificado enviado com sucesso." e seção Upload de certificado digital com campos Solicitante, Cooperativa origem (0703), Conta origem, Número de controle (1962059046), CPF/CNPJ, Data de upload (19/09/2023), Certificado digital (APLICACAO.csr) e Autenticação eletrônica](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-20.png)

**3.6 — Baixar os certificados aprovados**

Após o prazo de análise, o cliente deve acessar novamente **Outros Serviços > Acesso API PIX > Gerenciar Certificados**. Na linha do arquivo com situação **Aprovado**, baixe os dois arquivos disponíveis: **Certificado** (.CER) e **Cadeia** (cadeia completa).

![Tela Gerenciar Certificados do Internet Banking Sicredi com a entrada APLICACAO.csr datada de 19/09/2023 com situação Aprovado; dois botões de download: Certificado (com tooltip "Download certificado") e Cadeia (com tooltip "Download cadeia")](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-21.png)

**3.7 — Converter o certificado para .pem**

Após baixar o certificado `.cer`, converta-o para o formato `.pem` com o comando abaixo (substitua o nome do arquivo `.cer` pelo nome do arquivo baixado no banco):

```
openssl x509 -inform der -in 0887374000144N.cer -out certificate.pem
```

> **Nota:** O arquivo `.cer` baixado no banco pode vir no formato DER. Ferramentas como Postman e cURL utilizam o formato PEM — por isso a conversão é necessária. O nome `certificate.pem` pode ser qualquer nome de sua preferência.

![Prompt de Comando com o comando openssl x509 -inform der -in 0887374000144N.cer -out certificate.pem executado; ao lado, documento Sicredi descrevendo o Segundo Passo — Recebimento do certificado digital assinado pelo Sicredi com instruções para download do Certificado Digital .CER e Cadeia de Certificados Completa Sicredi .CER, e o comando de conversão para .pem](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-22.png)

**3.8 — Gerar as credenciais no Internet Banking**

No Internet Banking do Sicredi, acesse **Outros Serviços > Acesso API-PIX > Gerar Credenciais**, selecione o certificado gerado e solicite as credenciais em produção. O Banco Central (BACEN) pode levar até 48 horas para liberar o uso.

## Configurar a Conta no Gestão Administrativo

**4.1 — Acessar o cadastro de Contas**

No Gestão Administrativo, acesse o menu **Cadastro > Contas**.

![Menu do Gestão Administrativo com opção Contas destacada na lista, abaixo de Bancos e acima de Locais de Cobrança](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-23.png)

**4.2 — Cadastrar a conta Sicredi com os dados da API PIX**

Crie ou abra a conta do Sicredi e preencha os dados bancários (agência, conta, carteira) conforme liberado pelo banco. Nos campos específicos da integração PIX, preencha:

- **API Open Bank Client ID** — fornecido pelo Sicredi ao gerar as credenciais
- **API Open Bank Client Secret** — fornecido pelo Sicredi ao gerar as credenciais
- **Chave Pix** — chave registrada na conta
- **Certificado** — caminho do arquivo `certificate.pem` gerado (ex.: `C:\teorema\CertificadosAPI\certificate.pem`)
- **Certificado Chave** — caminho do arquivo `APLICACAO.key` (ex.: `C:\teorema\CertificadosAPI\APLICACAO.key`)

> ⚠️ **Atenção:** Os campos API Open Bank Client ID e API Open Bank Client Secret contêm credenciais de acesso à API bancária. Não compartilhe nem exponha esses valores.

![Tela Cadastro de Contas no Gestão Administrativo com a conta COOP_SICREDI (código 010) aberta; campos preenchidos incluindo Banco ECO COOP SICREDI S.A.-BANSICREDI, Agência com Dígito 0703, Número Conta 18544, Tipo de Conta Conta Corrente, SubConta com empresa N UTILIDADES DOMESTICAS E AGRÍCOLAS, CNPJ, Espécie de Cobrança Duplicata Mercantil, Cobrança Registrada, Lay-Out API, Tipo da Emissão Boleto Cliente Emite, API Open Bank Client ID, API Open Bank Client Secret, Chave Pix, campos Certificado e Certificado Chave com caminhos de arquivo preenchidos](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-24.png)

**4.3 — Acessar o cadastro de Tipos de Pagamento**

No Gestão Administrativo, acesse o menu **Cadastro > Tipos de Pagamento**.

![Menu do Gestão Administrativo com opção Tipos de Pagamento destacada na lista, abaixo de Moedas e acima de Tabela de Impostos](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-25.png)

**4.4 — Criar o tipo de pagamento PIX**

Crie um novo tipo de pagamento com os seguintes dados:

- **Descrição:** PIX - SICREDI (ou nome de sua preferência)
- **Tipo:** Entrada
- **Tipo Finalizadora:** PIX
- **Tipo Pagto para XML NFe:** 17 Pagamento Instantâneo (PIX)
- **Conta:** 010 - COOP. SICREDI
- **Sub Conta:** 1 - COOP. SICREDI

![Tela Cadastro de Tipos de Pagamento com o tipo PIX - SICREDI (código 016) aberto; campos Tipo Entrada, Tipo Finalizadora PIX, Tipo Pagto para XML NFe 17 Pagamento Instantâneo (PIX), Conta 010 COOP. SICREDI, Sub Conta 1 COOP. SICREDI preenchidos](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-26.png)

## Processar Pagamento Pix no Vendas PDV

**5.1 — Selecionar a finalizadora PIX no fechamento**

No Vendas PDV, ao realizar o fechamento da venda, na tela de Fechamento informe a **Finalizadora** como PIX (aba PIX ou campo Finalizadora com a condição PIX) e clique em **Gravar**. O sistema abrirá a tela de pagamento em PIX com o QR Code.

> **Nota:** Cada QR Code é válido para um único pagamento e expira após uma hora.

![Tela de Fechamento do Vendas PDV com Total a Receber R$ 3,40; aba PIX selecionada na barra de condições de pagamento (Dinheiro, PIX, Cheque, C. Crédito, C. Débito, Outros, Todos); campos Finalizadora PIX - SICREDI, Conta COOP_SICREDI, Entidade CONSUMIDOR e CPF/CNPJ preenchidos; botão Gravar destacado com valor R$ 3,40](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-27.png)

**5.2 — QR Code gerado para pagamento**

Ao gravar, o sistema exibe a tela de **Pagamento em PIX** com o QR Code gerado. O cliente pode ler o QR Code com o celular diretamente na tela ou utilizar o botão **Copiar QrCode**. O botão **Imprimir QrCode** permite imprimir o comprovante. A tela exibe o beneficiário, pagador, documento e data, e permanece com o status **"Aguardando Pagamento..."**.

![Tela Pagamento em PIX do Vendas PDV com QR Code gerado; campos Beneficiário (N UTILIDADES DOMESTICAS E AGRICOLAS), Pagador (CONSUMIDOR), Documento (964.202.439-04), Data (28/09/2023); botões Copiar QrCode e Imprimir QrCode; status Aguardando Pagamento exibido](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-versao-d/2023-09-28-14-33-33/2023-09-28-14-33-33-28.png)

## Veja também

Outros manuais relacionados ao chamado **0000441426**:

- [2023-09-27-14-14-25-Processo Sicredi](2023-09-27-14-14-25-processo)
- [Recebimento Pix SICREDI Utilizado No Vendas PDV](recebimento-pix-sicredi)

## Informações do documento

> Autor:
> Setor: Qualidade
> Módulo:
> Chamado: 0000441426
> Versão do Sistema:
> Versão do documento: 03
> Revisão:
> Aprovado em:

---

> 📎 **Arquivos originais:** [2023-09-28-14-33-33-Manual de Recebimento Pix SICREDI utilizado no Vendas PDV.docx](https://drive.google.com/uc?export=download&id=1hafvomZ4KBoA6cpoOybyusrz8xkl1S0L) · [Manual de Recebimento Pix SICREDI utilizado no Vendas PDV.pdf](https://drive.google.com/uc?export=download&id=1jo5DsiWbsB_QGD_qAp2OuNFn2ajTSlGM)