Módulo de pagamento para WHMCS · Cora · GPL

Boleto com Pix pela sua conta Cora. Fatura do WHMCS baixada sozinha, depois de conferida na Cora.

Se a sua empresa tem conta PJ na Cora, cada fatura do WHMCS ganha um boleto com QR Code Pix na sua própria conta, e o WHMCS baixa a fatura sozinho quando o cliente paga. Sem intermediário e sem taxa por fatura da nossa parte.

BR.S2 — O que o plugin faz

O cliente paga o Pix ou o boleto. O WHMCS confere na Cora e baixa.

Boleto com Pix

Cada fatura ganha, na sua conta PJ da Cora, um boleto registrado com QR Code Pix junto. O cliente paga como preferir.

Baixa conferida

A fatura só vira paga depois de o WHMCS reler o boleto na Cora e o valor cobrir o total.

Sem boleto em dobro

Abrir a fatura de novo mostra o mesmo boleto. Valor mudou: o antigo é cancelado antes do novo.

Cancela junto

Fatura cancelada no WHMCS cancela o boleto na Cora, para ninguém pagar uma fatura morta.

Vencimento, multa e juros

Você escolhe os dias até o vencimento, a multa e os juros ao mês depois dele.

Certificado só seu

O certificado e a chave da Cora ficam cifrados no seu WHMCS. Nenhum dado passa por servidor nosso.

Testado contra uma Cora simulada com a documentação oficial da API, com o pacote carregado num WHMCS 9 de verdade. O ambiente da própria Cora ainda não foi provado: antes de divulgar, gere uma fatura pequena e pague.

R$ 99,90 por ano por loja, no Pix, boleto ou cartão, com as atualizações e o suporte do ano, sem taxa por pedido. O arquivo é liberado na área do cliente assim que o pagamento é confirmado. As tarifas de boleto e Pix são as do seu plano na Cora.

BR.S3 — Como fica na loja

A fatura, com o Pix e o boleto.

Fatura do WHMCS com o Brasa Cora: valor, vencimento, QR Code Pix, código copia e cola, linha digitável e link do PDF do boleto
O que o cliente vê. O QR Code Pix, o copia e cola, a linha digitável e o PDF do boleto dentro da fatura, que baixa sozinha quando o pagamento entra.

O bloco do pagamento é o HTML que o módulo gera, com dados de exemplo, numa fatura montada para a foto. O código Pix e a linha digitável são de exemplo; no seu WHMCS vêm os da Cora, dentro do tema da sua área do cliente.

BR.S4 — Como instalar

Três passos, e o WHMCS já recebe pela Cora.

1. Envie os arquivos

Na área do cliente, baixe o .zip e descompacte na pasta raiz do WHMCS, a que tem o init.php. Ele só cria arquivos novos.

2. Cole as credenciais

Em Configurações, Pagamentos, Gateways de pagamento, ative o Brasa Cora, escolha o ambiente, cole o Client ID, o certificado e a chave e salve. O aviso de pagamento é cadastrado na Cora na primeira fatura.

3. Pague uma fatura pequena

Gere uma fatura de R$ 5,00 ou mais para você mesmo, pague o Pix e confira se ela foi baixada. Daí é só usar.

BR.S5 — Perguntas frequentes

O que perguntam antes de comprar.

Por que não usar o módulo da Cora que já existe?

O único módulo Cora para WHMCS, o Boleto Gratis - Cora do Marketplace do WHMCS, parou na versão 1.1 de dezembro de 2021: só boleto, sem Pix, e declara do WHMCS 8.0 ao 8.4. O WHMCS já está na versão 9. O Brasa Cora emite boleto e Pix na mesma cobrança e roda no WHMCS 8.8 em diante, inclusive no 9.

O que preciso na Cora?

Uma conta PJ na Cora com a Integração Direta: o Client ID, o certificate.pem e o private-key.pem, que saem no app ou no site da Cora, em Conta, Integrações via APIs. O certificado e a chave ficam cifrados no banco do seu WHMCS, com o segredo da sua instalação, e nada passa por servidor nosso.

Boleto ou Pix?

Os dois na mesma cobrança: cada fatura mostra o boleto, a linha digitável e o QR Code Pix com o copia e cola. Pagou por um, o outro deixa de valer, então ninguém paga duas vezes.

Como a fatura é baixada?

A Cora avisa o seu WHMCS, e o WHMCS relê o boleto na própria Cora antes de marcar a fatura como paga: o status tem de ser pago e o valor tem de cobrir a fatura. Se o aviso não chegar, a página da fatura e uma conferência de hora em hora pelo cron do WHMCS pegam o pagamento.

Abrir a fatura de novo gera outro boleto?

Não. O boleto fica guardado com a fatura e a página só mostra o mesmo. Se o valor da fatura mudou, o boleto antigo é cancelado na Cora antes de sair o novo, para o cliente não pagar o valor velho.

E se a fatura for cancelada?

Cancelar a fatura no WHMCS cancela o boleto na Cora, se ele ainda pode ser pago. O caminho inverso fica de fora de propósito: um boleto cancelado na Cora não cancela a fatura, porque isso cancelaria o serviço do seu cliente.

O que já foi testado, e o que não foi?

O contrato com a Cora foi testado contra uma Cora simulada com a documentação oficial da API (emitir, reler, cancelar e cadastrar o aviso), e o pacote que você baixa foi carregado dentro de um WHMCS 9 de verdade. Não foram provados o ambiente de teste nem a produção da própria Cora. Antes de divulgar, gere uma fatura pequena, de R$ 5,00 ou mais, para você mesmo, pague o Pix e confira se ela foi baixada; se algo não fechar, chame no WhatsApp.

E o estorno?

A versão 0.1 não faz o estorno pela Cora: devolva pelo app da Cora e registre o reembolso na fatura do WHMCS.

O que preciso para instalar?

WHMCS 8.8 ou mais novo, com PHP 8.1 ou mais novo e as extensões curl e openssl. As faturas têm de estar em Real e ter R$ 5,00 ou mais, que é o mínimo do boleto da Cora. O CPF ou CNPJ vem do campo de imposto do cliente no WHMCS ou de um campo personalizado com CPF, CNPJ ou documento no nome. Para o aviso automático, o WHMCS precisa responder em https.

E se eu não renovar a licença?

O módulo continua funcionando no seu WHMCS como está, porque ele não consulta licença nem desliga recurso. A fatura da renovação sai 20 dias antes do vencimento; sem pagamento, a licença fica suspensa 30 dias depois e a área do cliente deixa de liberar as versões novas e o suporte. Pagou depois, ela volta a ficar ativa sozinha.

BR.S6 — Suporte

Sua loja tem algo diferente?

Cartão, carnê, assinatura e estorno pela Cora ficam de fora da versão 0.1. Se o seu WHMCS precisa de outra coisa, ou se a primeira fatura não fechar, chame no WhatsApp. Você fala com quem escreveu o módulo.