Link Nacional
Nós criamos

seu site

de advocacia,de doação,de vendas,de empresa,de projeto,de portfólio

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

por | Atualizado em 2 de agosto de 2021 | Notícias

Pagamento com cartão de crédito

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 e recorrentes no cartão de crédito cadastrado dentro do WHMCS.

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.

Parcelamento em até 12x

O módulo disponibiliza recurso de parcelar a fatura em até 12x no cartão de crédito. Porém esse recurso não funciona corretamente na hora do pedido devido a uma limitação do WHMCS. Para parcelamentos em cartão de crédito recomendamos utilizar outro módulo.

Reembolso via WHMCS

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

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.
  • 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.
  • 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 ou superior
  • Compatível: PHP 5.6 ou PHP 7 ou superior
  • Última Versão Módulo: 3.1.1
  • Última atualização: 08/04/2020 14:19
Changelogs
  • v3.1.1 AJuste no Retorno do Reembolso
  • 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.

Módulo de doação

Módulos de doação

Redação: Link Nacional
A Companhia Link Nacional atua na área de tecnologia da informação (TI). E é especializada em oferecer serviços e soluções para internet. Fundada em 2004 na cidade de Ribeirão Preto/SP, hoje ela expandiu as suas áreas de negócios por todo o Brasil.
5 1 vote
Vote no Artigo
guest
Por favor entre com seu nome completo
Digite um endereço de email válido para uma possível notificação de retorno.
Número de whatsApp para eventual notificação de resposta.
26 Comentários
Inline Feedbacks
View all comments
CARLOS ROGERIO ALVES
CARLOS ROGERIO ALVES
18 de janeiro de 2019 09:26

os campos de cobrança de juros devem ser cobrados do cliente! fica a dica e sugestão!

CARLOS ROGERIO ALVES
CARLOS ROGERIO ALVES
18 de janeiro de 2019 16:37
Reply to  Link Nacional

Outra sugestão, que pode valorizar mais o módulo é colocar sistema de reembolso, ou seja, devolução do valor pago caso haja um cancelamento da venda do serviço ou produto caso tenha sido pago por cartão de crédito, como tem no PAYPAL!

Reginaldo
Reginaldo
22 de janeiro de 2019 14:00

Quando a transação nao é aceita mostrar o motivo.

Reginaldo
Reginaldo
22 de janeiro de 2019 14:00

Quando o cliente escolher a bandeira errada, ou informar isso com erro, ou o sistema corrigir automaticamente a bandeira na hora de salvar os dados, pois esta salvando com bandeira errada.

CARLOS ROGERIO ALVES
CARLOS ROGERIO ALVES
26 de janeiro de 2019 07:13

Olá amigos, adorei a atualização, porem verifiquei que criou um Hook para substituir o padrão do WHMCS com questão das bandeiras aceitas, e ficou faltando 2 bandeiras o Maestro e Visa Eletron, que são aceitas na API 3 da Cielo, ou podem acrescentar na próxima atualização uma forma de nós mesmos escolher as bandeiras que queremos aceitar!

Abraços e Sucessos!

CARLOS ROGERIO ALVES
CARLOS ROGERIO ALVES
29 de janeiro de 2019 10:24
Reply to  Link Nacional

Pelo email que eles me enviaram: como aqui não tem como anexar um print, vou colar as bandeiras:

>>>>>>>
Prezado Cliente,

A homologação da API Cielo e-Commerce foi realizada com sucesso! Agora você já pode realizar as vendas no seu site de forma rápida, simples e segura.

Endereço Virtual: (não informado)
Nome Fantasia: CARLOS ROGERIO ALVES
Número de Estabelecimento:
Bandeiras disponíveis: Visa, MasterCard, American Express, Aura, Diners, Discover, Elo, JCB, Visa Electron e Mastercard Débito

CARLOS ROGERIO ALVES
CARLOS ROGERIO ALVES
30 de janeiro de 2019 08:17
Reply to  Link Nacional

Não necessariamente, mas caso desejam, podem incluir em futuras atualizações, 🙂

CARLOS ROGERIO ALVES
CARLOS ROGERIO ALVES
15 de fevereiro de 2019 11:55
Reply to  Link Nacional

Qual valor para modulo de pagamento por cartão de débito?

Jucelio Silva Santos
Jucelio Silva Santos
3 de agosto de 2019 00:28

Amigo…. o modulo cielo credito está apresentando erro nas compras parceladas…. aceitando somente em 1x…

Richardson Douglas
Richardson Douglas
5 de agosto de 2019 14:53

o WHMCS Recentemente lançou uma atualização que permite armazenar vários cartões de crédito e também de debito.
Vocês vão atualizar o modulo para cartão de credito e de débito?
Sei que ele é um modulo diferente deste, mas agora é possível salvar vários cartões diferentes.
Sendo possível utilizar um sistema hibrido para salvar os 2 metodos de pagamento em um sistema de pagamento.

Max
Max
7 de setembro de 2020 01:16

Ola estou com este erro voce poderia me ajudar ?

UserID => 1

Andrade
Andrade
12 de dezembro de 2020 01:30

No cartão de crédito e débito o módulo consegue armazenar o cartão do meu cliente e na determinada data fazer o débito automático?

Últimas postagens

Os novos “ANALFABYTES”

Os novos “ANALFABYTES”

Os analfabytes são os analfabetos digitais que estão à margem da evolução tecnológica, dos benefícios da internet, da cibercultura e do ciberespaço.