Plugin Woocommerce Pagamento Sicredi API Boleto com Pix

Funcional em Versão Woocommerce
7.x, 8.x, 9.x, 10.x e 11.x (Outras versões e dúvida clique aqui!)

Plugin de Integração de Pagamentos Sicredi API – Boleto Registrado e Pix

Este plugin integra sua loja WooCommerce com o Sicredi via API oficial, permitindo a emissão automática de boletos registrados e recebimento via Pix integrado ao boleto (modelo híbrido). A confirmação de pagamento é realizada automaticamente via cron job e/ou webhook, atualizando o status do pedido na loja.

Perguntas Frequentes

P: O boleto é registrado?
R: Sim, registrado automaticamente pelo banco.
P: Aceita Pix?
R: Sim, o boleto inclui Pix integrado.
P: Pode ser pago em outro banco?
R: Sim, o boleto pode ser pago em qualquer banco.
P: Os pedidos são atualizados automaticamente?
R: Sim, via webhook e cron de consulta automática.
P: O que acontece se eu cancelar o pedido?
R: O boleto é baixado (cancelado) automaticamente junto ao Sicredi.
P: É preciso informar CPF/CNPJ no checkout?
R: Sim, o campo é exibido e validado (aceita CPF, CNPJ e CNPJ alfanumérico).
P: Posso aplicar desconto em pagamentos por boleto/Pix?
R: Sim, utilizando o plugin Woo Payment Discounts.

Requisitos

WooCommerce 5.x ou superior
Conta empresa no Sicredi com acesso à API Parceiro (cobrança)
Certificado SSL válido (e cURL habilitado no servidor)
PHP 7.1 a 8.x (testado até o PHP 8.4)
Compatível com o Checkout em Blocos (WooCommerce Blocks)
Opcional: plugin Extra Checkout Fields for Brazil para campos extras do checkout

Funcionalidades

Instalação e configuração simples
Boleto registrado via API Sicredi
Pix integrado ao boleto (modelo híbrido)
Campo de CPF/CNPJ validado no checkout clássico e no Checkout em Blocos
Aceita CNPJ alfanumérico (novo formato da Receita Federal)
Baixa automática do boleto ao cancelar o pedido
Gestão de pedidos emitidos via boleto
Debug e verificação de pagamentos
Atualização automática via webhook e cron
Webhook de status de pagamento
Segunda via do link no e-mail do cliente
QR Code Pix e código de barras gerados no navegador (sem CDN)

Novidades da versão 2.1

Aceita CNPJ alfanumérico (novo formato da Receita Federal) sem perder as letras no envio à API
Validação de CPF/CNPJ no checkout clássico e no Checkout em Blocos antes de chamar a API (sem boleto órfão no banco)
Baixa automática do boleto quando o pedido é cancelado, com anotação no pedido
Links de segunda via com hash forte por pedido (os links antigos continuam válidos no acompanhamento)
JavaScript do cupom/checkout em arquivos próprios, versionados por data de modificação (sem script embutido)

Licenciamento

O módulo é registrado com licença única válida por loja ou domínio.

Instalação e Configuração

Acesse o tutorial completo no link abaixo:

Ver Tutorial de Instalação

Changelog
Changelog	2.1 09/10/2026 - CPF/CNPJ do pagador passa a ser validado (com dígito verificador) ANTES de chamar a API do Sicredi, no checkout clássico e no Checkout em Blocos: documento vazio ou inválido mostra aviso amigável e nenhuma requisição é enviada ao banco - Aceita o CNPJ alfanumérico (novo formato da Receita Federal): as letras do documento não são removidas no envio à API - Baixa automática do boleto quando o pedido entra no status configurado como cancelado, com anotação do resultado no pedido (a falha não bloqueia o cancelamento e orienta a baixa manual) - Segunda via em PDF deixa de aceitar o hash previsível das versões anteriores (md5+sha1 do ID do pedido); o link antigo continua válido apenas na consulta de status, evitando acesso ao boleto de outros pedidos - Emissão considera qualquer resposta 2xx como sucesso (antes exigia exatamente HTTP 201) e trata 2xx sem os dados do boleto como erro, evitando boleto pago no banco sem registro no pedido - JavaScript do checkout/cupom movido para js/checkout.js (sem script embutido no HTML, que o wptexturize do WordPress pode corromper) e assets versionados pela data de modificação do arquivo - Chamadas à API sem repetição automática com a verificação de certificado desativada (o ajuste agora é explícito e documentado) - Novo filtro loja5_woo_sicredi_hibrido_base_url para apontar a API a um ambiente de testes local - Guia de instalação reescrito para este módulo (boleto híbrido) e descrição das funcionalidades atualizada 2.0 24/09/2026 - Refatoração completa do plugin seguindo o padrão Loja5 2.0 (base: plugin do Itaú Boleto) - Nova configuração remota via painel Loja5 (Lic_Client_Loja5 v3.0) com sincronização automática - Removido o licenciamento antigo (include/licenciamento.php e include/loja5.php com eval) - Schemas dos campos documentados em schema-config.json (Geral, Integração, Boleto e Status) - Nova classe de API (classes/class.api_sicredi_hibrido.php) centralizando token, boleto, PDF e webhook - Token de acesso em cache (transient) com renovação automática, sem gravar token em options - Verificação do certificado do servidor ativada por padrão nas chamadas à API Parceiro - Webhook: leitura do payload corrigida (antes nunca era processado) e confirmação via consulta na API - Ações administrativas (webhook e diagnóstico) passam a exigir permissão e nonce - Cron de status com token de segurança, com URL pronta exibida no painel - Segunda via em PDF com hash forte por pedido (compatível com os links já enviados) - Suporte ao Checkout em Blocos do WooCommerce (nova classe de integração e campo de CPF/CNPJ) - Código de barras e QR Code gerados no navegador com bibliotecas locais (sem GD e sem CDN) - Novo visual do cupom de pagamento, do e-mail e da segunda via em Minha Conta - Corrigida a paginação e os acessos a dados do boleto na lista de pedidos (removidos CDNs não usados) - Hooks de exibição de pagamento movidos para classes/hooks.php, fora do construtor do gateway - Removidas as propriedades dinâmicas (compatível com PHP 8.2+) mantendo suporte de PHP 7.1 a 8.x - Menu administrativo com permissão correta (antes era registrado sem capability) - Novo guia de instalação e configuração (guia.html) - Código de Acesso tratado como opcional no Modo Sandbox (a autenticação de testes usa credenciais fixas) - Webhook de cobrança: corrigido o cadastro (passa a enviar o evento LIQUIDACAO, sem o qual nada é notificado) - Webhook de cobrança: consulta passa a usar /webhook/contratos/ (lista de contratos) e a desinstalação usa PUT no contrato localizado - Webhook: URL de retorno agora leva token de segurança e as notificações são validadas (o Sicredi não assina o corpo) - Webhook: nota no pedido com valor recebido, forma (Pix/boleto) e data do evento; estornos são registrados sem alterar o status - Situações LIQUIDADO/LIQUIDADO PIX = pago e BAIXADO/VENCIDO = cancelado (comparação mais tolerante) - Código de barras calculado a partir da linha digitável quando a API não retorna o campo - Mensagens de erro da API mais completas (mensagens, violações, razão, httpMessage e detail) - Ações do webhook (instalar, consultar e desinstalar) agora exibem o resultado em aviso no painel administrativo - Pedido já pago passa a exibir a mensagem de pagamento confirmado (novo campo Mensagem de Pagamento Confirmado) no lugar dos dados do boleto/Pix - Pedido cancelado, recusado ou estornado não exibe mais o boleto para pagamento (mostra aviso de pedido cancelado) - E-mail do pedido só mostra os dados de pagamento enquanto o pedido está aguardando pagamento - Consulta do boleto na lista de pedidos: corrigido o "link expirado" (nonce do link) e o retorno agora é um relatório com a situação do boleto na API - Webhook: quando já existe contrato (mesmo inativo) o cadastro passa a reativar com PUT — o Sicredi responde 422 "Contrato já existente" ao tentar criar um segundo contrato - Painel: link "Instalar / Reinstalar" sempre disponível e mensagens do webhook mais claras (situação do contrato, id e eventos notificados) 1.0 02/03/2025 - lançamento inicial 1.1 18/08/2025 - adicionando funcionalidade de não retornar erro caso o arquivo de licenciamento loja5.php seja removido.

Changelog

Changelog

2.1
09/10/2026
- CPF/CNPJ do pagador passa a ser validado (com dígito verificador) ANTES de chamar a API do Sicredi, no checkout clássico e no Checkout em Blocos: documento vazio ou inválido mostra aviso amigável e nenhuma requisição é enviada ao banco
- Aceita o CNPJ alfanumérico (novo formato da Receita Federal): as letras do documento não são removidas no envio à API
- Baixa automática do boleto quando o pedido entra no status configurado como cancelado, com anotação do resultado no pedido (a falha não bloqueia o cancelamento e orienta a baixa manual)
- Segunda via em PDF deixa de aceitar o hash previsível das versões anteriores (md5+sha1 do ID do pedido); o link antigo continua válido apenas na consulta de status, evitando acesso ao boleto de outros pedidos
- Emissão considera qualquer resposta 2xx como sucesso (antes exigia exatamente HTTP 201) e trata 2xx sem os dados do boleto como erro, evitando boleto pago no banco sem registro no pedido
- JavaScript do checkout/cupom movido para js/checkout.js (sem script embutido no HTML, que o wptexturize do WordPress pode corromper) e assets versionados pela data de modificação do arquivo
- Chamadas à API sem repetição automática com a verificação de certificado desativada (o ajuste agora é explícito e documentado)
- Novo filtro loja5_woo_sicredi_hibrido_base_url para apontar a API a um ambiente de testes local
- Guia de instalação reescrito para este módulo (boleto híbrido) e descrição das funcionalidades atualizada

2.0
24/09/2026
- Refatoração completa do plugin seguindo o padrão Loja5 2.0 (base: plugin do Itaú Boleto)
- Nova configuração remota via painel Loja5 (Lic_Client_Loja5 v3.0) com sincronização automática
- Removido o licenciamento antigo (include/licenciamento.php e include/loja5.php com eval)
- Schemas dos campos documentados em schema-config.json (Geral, Integração, Boleto e Status)
- Nova classe de API (classes/class.api_sicredi_hibrido.php) centralizando token, boleto, PDF e webhook
- Token de acesso em cache (transient) com renovação automática, sem gravar token em options
- Verificação do certificado do servidor ativada por padrão nas chamadas à API Parceiro
- Webhook: leitura do payload corrigida (antes nunca era processado) e confirmação via consulta na API
- Ações administrativas (webhook e diagnóstico) passam a exigir permissão e nonce
- Cron de status com token de segurança, com URL pronta exibida no painel
- Segunda via em PDF com hash forte por pedido (compatível com os links já enviados)
- Suporte ao Checkout em Blocos do WooCommerce (nova classe de integração e campo de CPF/CNPJ)
- Código de barras e QR Code gerados no navegador com bibliotecas locais (sem GD e sem CDN)
- Novo visual do cupom de pagamento, do e-mail e da segunda via em Minha Conta
- Corrigida a paginação e os acessos a dados do boleto na lista de pedidos (removidos CDNs não usados)
- Hooks de exibição de pagamento movidos para classes/hooks.php, fora do construtor do gateway
- Removidas as propriedades dinâmicas (compatível com PHP 8.2+) mantendo suporte de PHP 7.1 a 8.x
- Menu administrativo com permissão correta (antes era registrado sem capability)
- Novo guia de instalação e configuração (guia.html)
- Código de Acesso tratado como opcional no Modo Sandbox (a autenticação de testes usa credenciais fixas)
- Webhook de cobrança: corrigido o cadastro (passa a enviar o evento LIQUIDACAO, sem o qual nada é notificado)
- Webhook de cobrança: consulta passa a usar /webhook/contratos/ (lista de contratos) e a desinstalação usa PUT no contrato localizado
- Webhook: URL de retorno agora leva token de segurança e as notificações são validadas (o Sicredi não assina o corpo)
- Webhook: nota no pedido com valor recebido, forma (Pix/boleto) e data do evento; estornos são registrados sem alterar o status
- Situações LIQUIDADO/LIQUIDADO PIX = pago e BAIXADO/VENCIDO = cancelado (comparação mais tolerante)
- Código de barras calculado a partir da linha digitável quando a API não retorna o campo
- Mensagens de erro da API mais completas (mensagens, violações, razão, httpMessage e detail)
- Ações do webhook (instalar, consultar e desinstalar) agora exibem o resultado em aviso no painel administrativo
- Pedido já pago passa a exibir a mensagem de pagamento confirmado (novo campo Mensagem de Pagamento Confirmado) no lugar dos dados do boleto/Pix
- Pedido cancelado, recusado ou estornado não exibe mais o boleto para pagamento (mostra aviso de pedido cancelado)
- E-mail do pedido só mostra os dados de pagamento enquanto o pedido está aguardando pagamento
- Consulta do boleto na lista de pedidos: corrigido o "link expirado" (nonce do link) e o retorno agora é um relatório com a situação do boleto na API
- Webhook: quando já existe contrato (mesmo inativo) o cadastro passa a reativar com PUT — o Sicredi responde 422 "Contrato já existente" ao tentar criar um segundo contrato
- Painel: link "Instalar / Reinstalar" sempre disponível e mensagens do webhook mais claras (situação do contrato, id e eventos notificados)

1.0
02/03/2025
- lançamento inicial

1.1
18/08/2025
- adicionando funcionalidade de não retornar erro caso o arquivo de licenciamento loja5.php seja removido.

Changelog
Changelog	2.1 09/10/2026 - CPF/CNPJ do pagador passa a ser validado (com dígito verificador) ANTES de chamar a API do Sicredi, no checkout clássico e no Checkout em Blocos: documento vazio ou inválido mostra aviso amigável e nenhuma requisição é enviada ao banco - Aceita o CNPJ alfanumérico (novo formato da Receita Federal): as letras do documento não são removidas no envio à API - Baixa automática do boleto quando o pedido entra no status configurado como cancelado, com anotação do resultado no pedido (a falha não bloqueia o cancelamento e orienta a baixa manual) - Segunda via em PDF deixa de aceitar o hash previsível das versões anteriores (md5+sha1 do ID do pedido); o link antigo continua válido apenas na consulta de status, evitando acesso ao boleto de outros pedidos - Emissão considera qualquer resposta 2xx como sucesso (antes exigia exatamente HTTP 201) e trata 2xx sem os dados do boleto como erro, evitando boleto pago no banco sem registro no pedido - JavaScript do checkout/cupom movido para js/checkout.js (sem script embutido no HTML, que o wptexturize do WordPress pode corromper) e assets versionados pela data de modificação do arquivo - Chamadas à API sem repetição automática com a verificação de certificado desativada (o ajuste agora é explícito e documentado) - Novo filtro loja5_woo_sicredi_hibrido_base_url para apontar a API a um ambiente de testes local - Guia de instalação reescrito para este módulo (boleto híbrido) e descrição das funcionalidades atualizada 2.0 24/09/2026 - Refatoração completa do plugin seguindo o padrão Loja5 2.0 (base: plugin do Itaú Boleto) - Nova configuração remota via painel Loja5 (Lic_Client_Loja5 v3.0) com sincronização automática - Removido o licenciamento antigo (include/licenciamento.php e include/loja5.php com eval) - Schemas dos campos documentados em schema-config.json (Geral, Integração, Boleto e Status) - Nova classe de API (classes/class.api_sicredi_hibrido.php) centralizando token, boleto, PDF e webhook - Token de acesso em cache (transient) com renovação automática, sem gravar token em options - Verificação do certificado do servidor ativada por padrão nas chamadas à API Parceiro - Webhook: leitura do payload corrigida (antes nunca era processado) e confirmação via consulta na API - Ações administrativas (webhook e diagnóstico) passam a exigir permissão e nonce - Cron de status com token de segurança, com URL pronta exibida no painel - Segunda via em PDF com hash forte por pedido (compatível com os links já enviados) - Suporte ao Checkout em Blocos do WooCommerce (nova classe de integração e campo de CPF/CNPJ) - Código de barras e QR Code gerados no navegador com bibliotecas locais (sem GD e sem CDN) - Novo visual do cupom de pagamento, do e-mail e da segunda via em Minha Conta - Corrigida a paginação e os acessos a dados do boleto na lista de pedidos (removidos CDNs não usados) - Hooks de exibição de pagamento movidos para classes/hooks.php, fora do construtor do gateway - Removidas as propriedades dinâmicas (compatível com PHP 8.2+) mantendo suporte de PHP 7.1 a 8.x - Menu administrativo com permissão correta (antes era registrado sem capability) - Novo guia de instalação e configuração (guia.html) - Código de Acesso tratado como opcional no Modo Sandbox (a autenticação de testes usa credenciais fixas) - Webhook de cobrança: corrigido o cadastro (passa a enviar o evento LIQUIDACAO, sem o qual nada é notificado) - Webhook de cobrança: consulta passa a usar /webhook/contratos/ (lista de contratos) e a desinstalação usa PUT no contrato localizado - Webhook: URL de retorno agora leva token de segurança e as notificações são validadas (o Sicredi não assina o corpo) - Webhook: nota no pedido com valor recebido, forma (Pix/boleto) e data do evento; estornos são registrados sem alterar o status - Situações LIQUIDADO/LIQUIDADO PIX = pago e BAIXADO/VENCIDO = cancelado (comparação mais tolerante) - Código de barras calculado a partir da linha digitável quando a API não retorna o campo - Mensagens de erro da API mais completas (mensagens, violações, razão, httpMessage e detail) - Ações do webhook (instalar, consultar e desinstalar) agora exibem o resultado em aviso no painel administrativo - Pedido já pago passa a exibir a mensagem de pagamento confirmado (novo campo Mensagem de Pagamento Confirmado) no lugar dos dados do boleto/Pix - Pedido cancelado, recusado ou estornado não exibe mais o boleto para pagamento (mostra aviso de pedido cancelado) - E-mail do pedido só mostra os dados de pagamento enquanto o pedido está aguardando pagamento - Consulta do boleto na lista de pedidos: corrigido o "link expirado" (nonce do link) e o retorno agora é um relatório com a situação do boleto na API - Webhook: quando já existe contrato (mesmo inativo) o cadastro passa a reativar com PUT — o Sicredi responde 422 "Contrato já existente" ao tentar criar um segundo contrato - Painel: link "Instalar / Reinstalar" sempre disponível e mensagens do webhook mais claras (situação do contrato, id e eventos notificados) 1.0 02/03/2025 - lançamento inicial 1.1 18/08/2025 - adicionando funcionalidade de não retornar erro caso o arquivo de licenciamento loja5.php seja removido.

Changelog

Changelog

2.1 09/10/2026 - CPF/CNPJ do pagador passa a ser validado (com dígito verificador) ANTES de chamar a API do Sicredi, no checkout clássico e no Checkout em Blocos: documento vazio ou inválido mostra aviso amigável e nenhuma requisição é enviada ao banco - Aceita o CNPJ alfanumérico (novo formato da Receita Federal): as letras do documento não são removidas no envio à API - Baixa automática do boleto quando o pedido entra no status configurado como cancelado, com anotação do resultado no pedido (a falha não bloqueia o cancelamento e orienta a baixa manual) - Segunda via em PDF deixa de aceitar o hash previsível das versões anteriores (md5+sha1 do ID do pedido); o link antigo continua válido apenas na consulta de status, evitando acesso ao boleto de outros pedidos - Emissão considera qualquer resposta 2xx como sucesso (antes exigia exatamente HTTP 201) e trata 2xx sem os dados do boleto como erro, evitando boleto pago no banco sem registro no pedido - JavaScript do checkout/cupom movido para js/checkout.js (sem script embutido no HTML, que o wptexturize do WordPress pode corromper) e assets versionados pela data de modificação do arquivo - Chamadas à API sem repetição automática com a verificação de certificado desativada (o ajuste agora é explícito e documentado) - Novo filtro loja5_woo_sicredi_hibrido_base_url para apontar a API a um ambiente de testes local - Guia de instalação reescrito para este módulo (boleto híbrido) e descrição das funcionalidades atualizada 2.0 24/09/2026 - Refatoração completa do plugin seguindo o padrão Loja5 2.0 (base: plugin do Itaú Boleto) - Nova configuração remota via painel Loja5 (Lic_Client_Loja5 v3.0) com sincronização automática - Removido o licenciamento antigo (include/licenciamento.php e include/loja5.php com eval) - Schemas dos campos documentados em schema-config.json (Geral, Integração, Boleto e Status) - Nova classe de API (classes/class.api_sicredi_hibrido.php) centralizando token, boleto, PDF e webhook - Token de acesso em cache (transient) com renovação automática, sem gravar token em options - Verificação do certificado do servidor ativada por padrão nas chamadas à API Parceiro - Webhook: leitura do payload corrigida (antes nunca era processado) e confirmação via consulta na API - Ações administrativas (webhook e diagnóstico) passam a exigir permissão e nonce - Cron de status com token de segurança, com URL pronta exibida no painel - Segunda via em PDF com hash forte por pedido (compatível com os links já enviados) - Suporte ao Checkout em Blocos do WooCommerce (nova classe de integração e campo de CPF/CNPJ) - Código de barras e QR Code gerados no navegador com bibliotecas locais (sem GD e sem CDN) - Novo visual do cupom de pagamento, do e-mail e da segunda via em Minha Conta - Corrigida a paginação e os acessos a dados do boleto na lista de pedidos (removidos CDNs não usados) - Hooks de exibição de pagamento movidos para classes/hooks.php, fora do construtor do gateway - Removidas as propriedades dinâmicas (compatível com PHP 8.2+) mantendo suporte de PHP 7.1 a 8.x - Menu administrativo com permissão correta (antes era registrado sem capability) - Novo guia de instalação e configuração (guia.html) - Código de Acesso tratado como opcional no Modo Sandbox (a autenticação de testes usa credenciais fixas) - Webhook de cobrança: corrigido o cadastro (passa a enviar o evento LIQUIDACAO, sem o qual nada é notificado) - Webhook de cobrança: consulta passa a usar /webhook/contratos/ (lista de contratos) e a desinstalação usa PUT no contrato localizado - Webhook: URL de retorno agora leva token de segurança e as notificações são validadas (o Sicredi não assina o corpo) - Webhook: nota no pedido com valor recebido, forma (Pix/boleto) e data do evento; estornos são registrados sem alterar o status - Situações LIQUIDADO/LIQUIDADO PIX = pago e BAIXADO/VENCIDO = cancelado (comparação mais tolerante) - Código de barras calculado a partir da linha digitável quando a API não retorna o campo - Mensagens de erro da API mais completas (mensagens, violações, razão, httpMessage e detail) - Ações do webhook (instalar, consultar e desinstalar) agora exibem o resultado em aviso no painel administrativo - Pedido já pago passa a exibir a mensagem de pagamento confirmado (novo campo Mensagem de Pagamento Confirmado) no lugar dos dados do boleto/Pix - Pedido cancelado, recusado ou estornado não exibe mais o boleto para pagamento (mostra aviso de pedido cancelado) - E-mail do pedido só mostra os dados de pagamento enquanto o pedido está aguardando pagamento - Consulta do boleto na lista de pedidos: corrigido o "link expirado" (nonce do link) e o retorno agora é um relatório com a situação do boleto na API - Webhook: quando já existe contrato (mesmo inativo) o cadastro passa a reativar com PUT — o Sicredi responde 422 "Contrato já existente" ao tentar criar um segundo contrato - Painel: link "Instalar / Reinstalar" sempre disponível e mensagens do webhook mais claras (situação do contrato, id e eventos notificados) 1.0 02/03/2025 - lançamento inicial 1.1 18/08/2025 - adicionando funcionalidade de não retornar erro caso o arquivo de licenciamento loja5.php seja removido.

R$169,99 no Pix

R$199,99 em 3x de R$66,66 sem juros no Cartão de Crédito
Instalação Inclusa*

Opções disponíveis

Link de sua loja

Versão Woocommerce

Instalação inclusa (primeira instalação).
Licença vitalícia (para uma única loja).
Suporte e acesso a atualizações gratis por 6 meses.

Ao comprar EU ACEITO os termos de compra li todas as funcionalidades e confirmo que possuo todos os requisitos listados na descrição no qual eu como comprador me responsabilizo por qualquer incompatibilidade ou não funcionamento por falta de algum requisito listado, no qual concordo com os termos de troca e devolução da loja.

0 comentários / Escreva um comentário