Módulo Pagamento Cartão de Crédito WHMCS via CIELO

Módulo Pagamento Recorrente WHMCS

Esse módulo de pagamento é integrado com o sistema WHMCS. É possível efetuar cobrança direto no cartão de crédito do usuário, automatizar o pagamento recorrente direto no cartão de crédito cadastrado e reembolsar os valores pagos direto pelo WHMCS.

Módulo Cartão de Crédito transparente para o WHMCS CIELO

Para cartões de crédito: Visa, Master, Amex, Elo, Aura, JCB, Diners, Discover, Hipercard.

Licença R$59,95 por ano

Principais Recursos do módulo CIELO para WHMCS:

Conheça os todos os recursos do módulo transparente de cartão de crédito para o WHMCS. Esse módulo é utilizado para efetuar cobranças automáticas no cartão de crédito cadastrado dentro do sistema.

Salva número do cartão no WHMCS

Dentro do WHMCS o usuário pode armazenar os dados do cartão de crédito dentro de sua conta, facilitando os próximos pagamentos. Para maior segurança os dados armazenados do cartão de crédito é um token gerado pela CIELO, garantindo o sigilo dos dados do usuário dentro do WHMCS.

Ao clicar no botão “Tentar Capturar” na fatura é possível efetuar a cobrança manualmente direto no cartão de crédito cadastrado do usuário.

Reembolso via WHMCS

O módulo possui reembolso automático via WHMCS agilizando o reembolso de faturas errôneas ou estornos.

Parcelamento em até 12x

O módulo disponibiliza recurso de parcelar a fatura em até 12x no cartão de crédito.

Confira a lista com todos os recursos do módulo

Abaixo segue uma lista com todos os recursos disponíveis no módulo atual.

  • Integrado com sistema WHMCS.
  • Validação do Cartão com operadora.
  • Pagamentos recorrente automático. 
  • Retorno automático de pagamentos.
  • Débito automático no cartão pelo WHMCS.
  • Captura de pagamento pela fatura.
  • Erros de pagamento direto da operadora.
  • Hook para novos cartões de crédito.
  • Opção de Parcelar Fatura em até 12x.
  • Atualização e suporte incluso.
  • Cartão salvo em Token.
  • Captura de pagamento pela fatura.
  • Erros de pagamento direto da operadora.
  • Hook para novos cartões de crédito.
  • Opção de Parcelar Fatura em até 12x.
  • Atualização e suporte incluso.
  • Configuração de juros para comprador ou loja
  • Reembolso via WHMCS
  • Suporte Versão Multi Cartões WHMCS 7.8

Informações técnicas

  • Compatível: WHMCS > 7.8 e PHP 5.6 ou PHP > 7
  • Última Versão Módulo: 3.1
  • Última atualização: 29/11/2019 10:39
Changelogs
  • v3.1 Ajustes na bandeira American Express

Como instalar o módulo Cartão de Crédito transparente para o WHMCS via CIELO

Primeiramente crie uma conta na cielo e ative o serviço da CIELO API E-Commerce. Após homologado eles irão fornecer duas chaves o MerchantKey e a MerchantID, que serão utilizados para configurar o módulo.

Efetue o pedido do modulo clicando no botão “Comprar”, faça o pagamento, assim que o pagamento for confirmado o link de download ficará disponível.

1º Passo | Primeiro passo após a confirmação de pagamento

Download e Descompactar o arquivo

Faça o download do módulo, o arquivo esta compactado em .zip. Após baixar o arquivo descompacte-o,  terá 3 pastas, entretanto suba somente as pastas: includes e modules para o diretório raiz do WHMCS.

Essa configuração é opcional: Dentro  da pasta lang existe uma subpasta chamada overrides, ela contém um arquivo chamado _portuguese-br.php. Esse arquivo possui uma tradução personalizada para o módulo do cartão de crédito para o WHMCS. Renomeie o arquivo para: portuguese-br.php e suba a pasta lang inteira para o diretório raiz do seu WHMCS. Mas atenção caso tenha um arquivo com o mesmo nome recomendamos copiar o conteúdo do arquivo e colocar dentro do seu arquivo já existente em sua instalação do WHMCS.

2º Passo | Ativar Modulo

Acesse a área administrativa do WHMCS, acesse o menu “Opções” >> “Pagamentos” >> Portais para Pagamento. Na página do “Portais de pagamento”, procure pela opção e clique no botão “Cielo API Cartão de Crédito”. 

3º Passo | Configuração CIELO Modulo

Tela de configurações do módulo

Para o módulo funcionar corretamente é obrigatório inserir a licença, a licença fica disponível na área do cliente.

Abaixo segue tela com as configurações do módulo de pagamento da CIELO para o WHMCS.

4º Passo | Ativação avançada de validação de cartão

Configuração opcional

Esse recurso chamado ZEROAUTH valida se o cartão está ativo junto a operadora de cartão de crédito, recurso disponível para as bandeiras: MasterCard, Elo e Visa. Para ativar esse recurso é necessário solicitar ativação do serviço ZEROAUTH na CIELO. 

Abaixo segue modelo de email para solicitar o ZEROAUTH na CIELO.
Endereço: cieloecommerce@cielo.com.br 
Assunto: Estabelecimento (insira o número do estabelecimento) – solicitação de ativação do serviço ZEROAUTH
Mensagem: Por favor habilitar o recurso ZEROAUTH pro meu estabelecimento.

5º Passo | Configuração de segurança do WHMCS

Configurações Gerais no WHMCS

Versão até 7.7
Ainda na aba de “Segurança” em “Configurações Gerais”, desmarque e marque as opções conforme imagem abaixo:

Versão após 7.8
Ainda na aba de “Segurança” em “Configurações Gerais”, não inclui mais a opção: “Desativar Armazenamento de Cartões de Crédito”. Entretanto tem a opção para deletar os tokens do cartão de crédito, veja imagem abaixo:

6º Passo | Solicitando liberação de captura sem o CVV

Efetuando capturas de pagamentos sem código de segurança

Após todas informações configuradas é necessário enviar um email para a CIELO solicitando a liberação da captura de pagamentos pelo cartão de crédito sem o código de segurança, o prazo de resposta é de até 7 dias úteis. Segue abaixo modelo de email a ser enviado para o endereço: cieloecommerce@cielo.com.br 

Endereço: cieloecommerce@cielo.com.br 
Assunto: Estabelecimento (insira o número do estabelecimento) – solicitação de liberação de transação sem o CVV
Mensagem: Por favor liberar a captura de pagamentos sem o código de segurança (CVV), porque quando o usuário utiliza o cartão de crédito e habilita a opção de salvar o cartão em nosso site nos armazenamos o token para futuros pagamentos de mensalidade.

Como corrigir os erros?

“Oops! Something went wrong and we couldn’t process your request. Please go back to the previous page and try again. Error: Gateway Module “moipPDBoleto” Not Activated” 

Quando algum erro surgir, acesse o administrativo do WHMCS entre em “Opções” >> “Configurações Gerais. Acesse a aba “Outros” habilite os itens “Display Errors” e “Log Errors”. E informe o erro detalhado nos comentários dessa página que iremos resolver de imediato o problema.

Erro ao pagar a primeira fatura com o módulo

“O cartão que você informou foi recusado. Por favor, tente usar um outro cartão ou entre em contato com o Suporte.” 

Esse erro pode ser por alguma configuração errada: na CIELO, no módulo do WHMCS ou no próprio WHMCS. Segue as etapas de verificação:

  1. Confira se todas as liberação informadas nos passos acima com a CIELO foram concluídas.
  2. Verifique as configurações do módulo, se existe algo configurado erroneamente, veja passo 3.
  3. Verifique as configurações do WHMCS como informado acima no passo: 5.
  4. Acesse o admin do WHMCS entre em “Transações” >> “Log” e veja se existe alguma informação referente ao pagamento.

Erro após atualização de módulo para o WHMCS 7.8

“Após atualização do módulo para o WHMCS 7.8 ou superior, o módulo não esta mais capturando os pagamentos, ” 

Caso o módulo apresente erro nos pagamentos, por favor acesse a opção do menu “Transações” >> “Log” e verifique a mensagem do Log. Se for de licença inválida, por favor verifique o passo 3.

Como remover campo data início

Campo excedente data de início. Se na área do cliente ao informar o cartão de crédito e aparecer o campo data de início, conforme abaixo:

Dentro do admin do WHMCS acesse: Configurações Gerais > Fatura e desabilite o recurso Número da falha/Data de início.

Erro: Braspag.CommonTypes.Enums.BrandEnum’. Path ‘CreditCard.Brand’

Esse erro é devido ao tipo da bandeira do cartão. As vezes a nomenclatura do cartão pode estar errada. O erro completo que aparece nos logs da transação do WHMCS é:

Message => Error converting value “Card” to type ‘Braspag.CommonTypes.Enums.BrandEnum’. Path ‘CreditCard.Brand’, line 1, position 313.

No caso do módulo esse erro ocorre porque o tema utilizado no WHMCS não é compatível com a versão 7.8.3 do WHMCS. Tente alterar o tema para o template padrão do WHMCS (Six) e tente fazer um novo cadastro de cartão.

WhatsApp chat