Documentação — Plugin C6 Bank para WooCommerce

Guia completo de instalação, configuração e troubleshooting do gateway C6 Bank (Pix, Boleto e Cartão) no WooCommerce.

Produto oficial à venda

Esta documentação refere-se exclusivamente ao produto oficial vendido pela TecnoMicro:

Ver produto e comprar o plugin

Atenção: não oferecemos suporte para versões modificadas, redistribuídas ou obtidas fora do site oficial.

Sumário

1. Visão geral
2. Requisitos e compatibilidade
3. Instalação do plugin
4. Configuração inicial
5. Configuração do Pix
6. Configuração do Boleto
7. Configuração do Cartão
8. Webhook e atualização automática
9. Fluxo do pedido no WooCommerce
10. Logs, auditoria e diagnóstico
11. Erros comuns e soluções
12. Perguntas frequentes
13. Licença e atualizações
14. Changelog
15. Suporte oficial

1) Visão geral

O Plugin C6 Bank para WooCommerce integra sua loja às APIs do C6 Bank para receber pagamentos via:

• Pix: geração de cobrança, QR Code, Pix Copia e Cola e atualização automática de pagamento.
• Boleto: geração de boleto com PDF, código de barras/linha digitável e atualização via webhook.
• Cartão de Crédito: pagamento via checkout seguro do C6 Bank com parcelamento em até 12x sem juros.
• Cartão de Débito: pagamento à vista via checkout seguro do C6 Bank com autenticação 3DS.

2) Requisitos e compatibilidade

• WordPress atualizado
• WooCommerce atualizado (com suporte a HPOS — High-Performance Order Storage)
• SSL ativo (HTTPS) no domínio
• PHP 7.4 ou superior
• Servidor com suporte a TLS moderno e cURL com suporte a certificados de cliente
• Permissão de escrita em wp-content/uploads (para certificados mTLS e logs)
• Conectividade de saída liberada (HTTPS) para os endpoints do C6 Bank

3) Instalação do plugin

1. Acesse WordPress → Plugins → Adicionar novo → Enviar plugin.
2. Envie o arquivo .zip do plugin e clique em Instalar agora.
3. Ative o plugin.
4. Vá em WooCommerce → Configurações → Pagamentos e habilite os métodos desejados.
5. Configure sua licença em WooCommerce → Licença C6 Bank para receber atualizações automáticas.

4) Configuração inicial

4.1) Credenciais e ambiente

Configure as credenciais conforme seu contrato no C6 Bank. Se houver opção de Homologação e Produção, selecione corretamente o ambiente para evitar recusas e erros de autenticação.

4.2) Certificados (mTLS) e chaves

As APIs do C6 Bank exigem mTLS (autenticação mútua com certificado do cliente). No painel do plugin, faça upload do certificado e chave privada nos formatos aceitos (ex.: .crt/.key ou .pem).

• Certificado: arquivo público do cliente (ex.: client.crt ou client.pem)
• Chave privada: arquivo privado correspondente (ex.: client.key ou client-key.pem)

5) Configuração do Pix

5.1) Habilitar método

1. WooCommerce → Configurações → Pagamentos
2. Ative C6 Bank — Pix
3. Abra as configurações e ajuste título/descrição exibidos no checkout

5.2) Tela do cliente (QR Code / Pix Copia e Cola)

Após finalizar o pedido, o cliente verá:

• QR Code Pix
• Código "Pix Copia e Cola" com botão de copiar
• Instruções de pagamento e prazo de vencimento

5.3) Status do pedido

Ao gerar o Pix, o pedido fica com status "Pendente pagamento". Após o pagamento ser confirmado (via webhook ou consulta automática), o status muda automaticamente para "Processando".

5.4) Atualização automática do pagamento

O plugin atualiza automaticamente o status do pedido via Webhook (notificação do C6 Bank) e também possui consulta periódica (polling) como fallback caso o webhook não chegue.

6) Configuração do Boleto

1. WooCommerce → Configurações → Pagamentos
2. Ative C6 Bank — Boleto
3. Configure título/descrição e regras de vencimento

6.1) Tela do cliente

Após finalizar o pedido, o cliente verá o boleto com código de barras, linha digitável e botão para baixar o PDF do boleto.

6.2) Status do pedido

Ao gerar o boleto, o pedido fica com status "Aguardando" (on-hold). Após a compensação bancária ser confirmada via webhook, o status muda automaticamente para "Processando".

7) Configuração do Cartão

7.1) Cartão de Crédito

O pagamento por cartão de crédito opera em modo redirecionado — o cliente é enviado ao ambiente seguro do C6 Bank para inserir os dados do cartão.

• Parcelamento: até 12x sem juros para o cliente (o lojista absorve os encargos).
• Parcelas máximas: defina nas configurações do gateway até quantas parcelas deseja oferecer.
• Valor mínimo da parcela: configure o valor mínimo por parcela (padrão: R$ 20,00).

7.2) Cartão de Débito

O pagamento por débito também opera em modo redirecionado, sempre à vista (1x) e com autenticação 3DS obrigatória.

7.3) Status do pedido

Ao gerar o checkout, o pedido fica com status "Aguardando" (on-hold). Após o pagamento ser confirmado via webhook ou retorno do C6, o status muda automaticamente para "Processando".

8) Webhook e atualização automática

8.1) O que é

Webhook é uma notificação enviada pelo C6 Bank ao seu site quando ocorre um evento (ex.: pagamento confirmado). Isso permite que o pedido seja atualizado automaticamente sem depender apenas de consultas periódicas.

8.2) Webhooks disponíveis

O plugin registra rotas separadas para cada método de pagamento:

• Pix: webhook para confirmação de pagamento Pix
• Boleto: webhook para confirmação de compensação bancária
• Cartão (Crédito e Débito): webhook para confirmação do checkout

8.3) Configurar no painel do C6

1. Cadastre a URL de webhook do seu site no painel/console do C6 (conforme seu contrato/documentação).
2. Selecione os eventos relacionados (Pix/Boleto/Cartão, conforme aplicável).
3. Salve e realize um teste (se o C6 oferecer ferramenta de teste).

9) Fluxo do pedido no WooCommerce

Cada método de pagamento possui um fluxo de status específico:

10) Logs, auditoria e diagnóstico

10.1) Ativar modo debug

Ative a opção Debug/Logs nas configurações do plugin (quando disponível). Com isso, o plugin registra:

• Requisições e respostas da API do C6 Bank
• Eventos de webhook recebidos
• Erros HTTP (400/401/403/500/503 etc.)

10.2) Onde ver logs no WooCommerce

1. WooCommerce → Status → Logs
2. Selecione a fonte do log: c6_pix, c6_boleto, c6_checkout (cartão/débito)

11) Erros comuns e soluções

12) Perguntas frequentes (FAQ)

13) Licença e atualizações

13.1) Como funciona

O plugin utiliza um sistema de licença para gerenciar atualizações automáticas. A licença é vinculada ao domínio do seu site.

13.2) Estados da licença

• Ativa: plugin funciona normalmente + recebe atualizações automáticas.
• Expirada: plugin continua funcionando normalmente, mas não recebe mais atualizações. Renove para voltar a receber updates.
• Sem licença: plugin funciona normalmente, sem atualizações. Cadastre para receber updates.
• Revogada: todos os gateways de pagamento são bloqueados. Entre em contato com a TecnoMicro.

13.3) Configurar licença

1. Acesse WooCommerce → Licença C6 Bank
2. Insira o e-mail e a chave de licença recebidos na compra
3. Clique em Salvar e validar

13.4) Atualizações automáticas

Com licença ativa, o WordPress verifica automaticamente se há nova versão e exibe o aviso padrão na tela de Plugins. Basta clicar em "Atualizar agora".

14) Changelog

15) Suporte oficial TecnoMicro

O suporte é prestado exclusivamente para clientes com licença válida adquirida no site oficial. Para agilizar o atendimento, tenha em mãos o número do pedido WooCommerce.