Plugin Cielo API 3.0 para o GiveWP
Como solicitar a plataforma de doações?
Para desenvolvedores
Essas duas opções de licença dos plugins é recomendada para usuário experiente em WordPress e GiveWP. É possível solicitar individualmente um ou mais plugins ou adquirir uma licença única que irá permitir a instalação de todos os plugins atuais e futuros.
Para instituições
Essa é uma solução completa ideal para o terceiro setor, irá receber a plataforma pronta e configurada em pleno funcionamento. Solução integrada ao site e apta ao recebimento das doações. Além disso, também terá um treinamento completo para aprender como utilizar a plataforma.
Recursos do plugin
Doação recorrente
Disponibilize doações recorrentes automáticas de forma opcional ou obrigatória na doação. Quando a doação é definida como recorrente o valor será debitado automáticamente todo mês no cartão de crédito do doador.
Estorno de doação
Possibilidade de estornar o valor da doação pela área administrativa da doação, o estorno do valor vai direto para o cartão de crédito utilizado.
Doações parceladas
Facilite para o doador e ofereça opção de doação parceladas em até 12 vezes no cartão de crédito.
Aceita diversas moedas
Os doadores estrangeiro podem efetuar doações através das suas moedas nacionais, pois este plugin tem o recurso de integração com o plugin gratuito de multimoedas para o GiveWP, que possibilita o recebimento de doações em outras moedas, tornando também o processo de realização das doações mais rápido e fácil.
Captura manual de doação
Quando o doador finaliza a doação, ela fica num primeiro momento pendente até que o administrador do site autorize a cobrança no cartão de crédito do doador. Essa autorização de cobrança o administrador faz dentro do painel administrativo do WordPress, acessando o menu lateral e clicando no item Doações. Dentro da área de Doações é possível capturar (cobrar) manualmente o valor doado do cartão de crédito. E assim também pode-se fazer uma melhor verificação de fraude e/ou análise da doação.
Configuração individual por formulário
O administrador do site pode definir as configurações do módulo globalmente; e dessa maneira as configurações feitas valerão para todos os formulários. Mas também há a possibilidade de configurar os formulários de maneira individual, de modo que eles tenham certas características para atenderem ao fim desejado. Por exemplo, pode-se um formulário de doações recorrentes, com possibilidade de parcelamento, é possível adicionar outras chaves da CIELO e assim por diante. É essa característica que faz o plugin ser bastante versátil.
- Recebimento de doações Dólar, Iene, Euro e Real
- Estorno de doações
- Pagamento de doação em até 12x
- Integração com Anti Fraude
- Opção de captura automática e manual
- Configuração personalizada por formulário
- Doações por assinatura mensal
- Doação recorrente mensal automática
Plugin Cielo API 3.0 para o GiveWP
Como o plugin CIELO API 3.0 funciona no GiveWP?
o plugin CIELO API 3.0 é uma solução de pagamento para sistemas de doação online que utilizam o GiveWP. Com ela é possível realizar doações com cartões de crédito das mais diversas bandeiras. Nesse tutorial, você vai ver como integrar o CIELO API 3.0 com o plugin GiveWP, demonstaremos como baixar, instalar o plugin no WordPress e configurar o formulário de doação.
A vantagem em fazer a integração do CIELO API 3.0 é propiciar mais uma opção de pagamento para quem pretende fazer doações no seu site. Essa solução é ideal para quem procura pratiticidade e segurança na hora de inserir os dados bancários. Já que você conta com a tecnologia de uma das gigantes no setor de pagamentos eletrônicos, que é a Cielo.
Compatibilidade com formulários:
- Multi-step
- Legacy
- Em breve no GiveWP 3.0.
GiveWP plugin de doação WordPress
O GiveWP é um poderoso plugin para o WordPress. A plataforma transforma o seu site em um sistema de doação completo. A configuração dessa solução é com a gente mesmo.
Como baixar o plugin da Cielo para GiveWP?
Antes de baixar o plugin da Cielo é necessário adquirir o plugin individualmente ou o pacote com todos os plugins disponibilizados pela Link Nacional.
Para fazer o download do plugin de integração da Cielo com o GiveWP é necessário acessar a área de cliente da Link Nacional e seguir os passos abaixo:
1º passo:
Acesse o menu > suporte > Downloads;
2º passo:
Clique em plugins WordPress;
3º passo:
Clique em plugin GiveWP Cielo API 3.0 para GiveWP e salve o arquivo no seu computador.
Licença da Link Nacional
Após adquirir a licença do plugin para o GiveWP é necessário acessar a área do cliente da Link Nacional, clicar no menu > serviços > minhas licenças. Basta copiar o código da licença e deixar salvo para ser utilizado na hora da configuração do plugin.
Como instalar o plugin CIELO no WordPress
- Entrar no painel administrativo do seu WordPress, ex: “www.meudominio.com/wp-admin”;
- Na barra lateral esquerda acessar o item plugins e depois adicionar novo;
- Clique na opção enviar plugin e procure no seu computador o arquivo;
- Após selecionar o arquivo clique em instalar agora;
- Após a instalação com sucesso clique no botão ativar plugin;
- Pronto, o seu plugin já está instalado.
1º passo:
Entrar no painel administrativo do seu WordPress, ex: “www.meudominio.com/wp-admin”;
2º passo:
Na barra lateral esquerda acessar o item plugins e depois adicionar novo;
3º passo:
Clique na opção enviar plugin e procure no seu computador o arquivo que fez download no 4º passo do item anterior;
4º passo:
Após selecionar o arquivo clique em instalar agora, após instalar ative o plugin.
Como configurar o plugin CIELO API GiveWP
Após instalar o plugin e ativa-lo veja abaixo como seguir com as principais configurações do plugin. Caso tenha dificuldade em ativar o plugin leia a seção de como corrigir erros do plugin.
5º passo:
Com o plugin ativado é hora de configurar o plugin, e o primeiro passo é acessar as configurações do plugin. Entre em Doações > Configurações > Cielo API 3.0. Na tela de configurações seguiremos com os ajustes.
6º passo:
A primeira configuração é adicionar a Licença do plugin adquirida junto a Link Nacional, essa informação foi enviada para o e-mail de cadastro ou pode obter a licença dentro da área do cliente. Se não tem uma licença, solicite uma agora.
7º passo:
Os dois campos seguintes referem-se às credenciais da CIELO API 3.0: Cielo Merchant Key e Merchant ID.
8º passo:
Esse campo é a descrição que irá aparecer na fatura do cartão de crédito do doador, esse campo deve ser preenchido com até 12 caracteres, não pode ter espaço nem acentuação. Nossa sugestão para o preenchimento desse campo seria: DOACAO.
9º passo:
Com o recurso de recorrência habilitada o doador pode optar por fazer da doação um pagamento recorrente mensal do valor no cartão de crédito, sendo assim a doação ficará e débito automático no cartão de crédito do doador. O campo de descrição da recorrência é um campo para personalizar o texto que aparece para o doador na hora de selecionar a recorrência.
O recurso de recorrência obrigatória transforma a doação recorrente como obrigatória, ou seja o doador não terá opção de fazer uma doação avulsa.
10º passo:
A opção de habilitar a captura de transação faz com que a cobrança do cartão seja automática. Ao deixar desabilitada o administrador do site tem até 3 dias para capturar a doação. Normalmente esse recurso fica desativado para que a doação antes de ser capturada o administrador do site possa verificar a veracidade da doação.
11º passo:
Essa configuração do tipo de ambiente defini se as chaves (MerchandId e MerchantKey) configuradas dentro do plugin são de Produção ou Sandbox. Atenção: toda chave fornecida pela CIELO é de Produção. A opção SandBox é habilitada apenas para fins de desenvolvimento, nunca selecione a opção SandBox exceto se você souber o que esta fazendo.
12º passo:
Esta opção deverá ser habilitada somente para testes e verificação de erros, não deixe o recurso habilitado por muito tempo.
13º passo:
Ao habilitar detalhes da cobrança, o formulário de doação irá mostrar mais campos para o doador preencher antes do pagamento da doação.
14º passo:
A validação de cartão é um serviço da CIELO denominado BIN que é útil para verificar se o cartão de crédito está apto a fazer uma transação financeira. Esse recurso precisa solicitar a ativação junto a CIELO, e após liberação é habilite o recurso.
15º passo:
Ao habilitar esse recurso o doador terá disponível a seleção de parcelamento do pagamento da doação.
16º passo:
O campo CVV são os dígitos de segurança do cartão de crédito, ao desabilitar o doador não terá obrigatoriedade de inserir essa informação no formulário de doação, entretanto para funcionar é necessário solicitar a liberação de transação sem CVV junto a CIELO.
O campo de quantidade máxima de números do CVV é um limitador para quantos dígitos o campo de número CVV vai ficar limitado.
Como corrigir problemas
O plugin esta em produção sem nenhuma falha identificada no momento, entretanto ao instalar o plugin, se o ambiente no qual foi instalado não estiver preparado o mesmo pode apresentar falhas que normalmente são simples de resolver.
- Verifique a versão do PHP, altere para a mais recente ou uma versão anterior.
- Verifique se a biblioteca IONCUBE esta habilitada, normalmente pode ser ativada diretamente pelo painel de controle da Hospedagem dentro das configurações do PHP.
Changelogs
Versão 2.3.4
- Correção de erro crítico e falha no tratamento de erros;
- Otimização na formatação do código;
- Adição de EULA.
Data da atualização: 22/09/2023
Versão 2.3.3
- Correção de bug de conversão para moedas internacionais.
Data da atualização: 02/06/2023
Versão 2.3.2
- Correção de bug de reconhecimento de recorrência obrigatória.
Data da atualização: 23/05/2023
Versão 2.3.1
- Correção de bug de detecção incorreta de chaves da Cielo;
- Melhoria de mensagem de erro para doações recorrentes.
Data da atualização: 16/05/2023
Versão 2.3.0
- Melhoria do reconhecimento de doações recorrentes;
- Verificação de bin de cartão com 8 dígitos;
- Frase de recorrência customizada;
- Correção de bug no salvamento de configuração de “recorrência obrigatória”;
- Adicionada configuração para desabilitar CVV, necessita habilitar junto a Cielo;
- Retirar label mensal da descrição de recorrência;
- Adicionada configurações de plugin por formulário;
- Adicionado botão na página de configurações para download de logs de erros;
- Correção de bug de renderização de checkbox no template multi-step;
- Checkbox de recorrência e parcelamento abaixo dos detalhes do faturamento.
Data da atualização: 16/05/2023
Versão 2.2.0
- Adicionado configuração de alteração de recorrência;
- Adicionado botão de estorno de pagamentos;
- Adicionada opção de doações parceladas com valores acima de 10 R$;
- Melhoria dos logs de doações;
- Otimização de código.
Versão 2.1.0
- Correção de bug no script de verificação de licenças;
- Atualização de endpoint de atualizações automáticas.
Versão 2.0.0
- Implementação de doações recorrentes;
- Atualização de logs de doação e quebra de compatibilidade.
Versão 1.5.0
- Implementada opção de captura manual;
- Correção de bug de renderização de metadados e logs de doação.
Versão 1.4.3
- Correção de bug no script de verificação de licença.
Versão 1.4.2
- Correção de arquivo de desinstalação que estava apagando configurações do 3DS;
- Alteração da nomenclatura das funções de registro de logs para garantir que não hajam colisões com outros plugins;
- Ajustes no salvamento dos metadados de cada doação para ser compatível com outras respostas da Cielo.
Versão 1.4.1
- Retirada de variáveis globais desnecessárias;
- Ajuste na função de registro de log de erros;
- Heredoc implementado na função de metadados;
- Correção de Bug dos metadados da doação.
Versão 1.4.0
- O plug-in aceita o formato de data de expiração do cartão MM/YY e converte automaticamente para MM/YYYY, que é o formato aceito pela CIELO;
- O usuário pode escolher o número de caracteres do CVV (entre 3 e 24 números) no painel de administração do plug-in;
- Link “Saiba mais” adicionado no painel de metadados da doação;
- Mensagem de “entre em contato com a CIELO” é exibida nos metadados da doação caso o plug-in não tenho conseguido uma resposta do servidor da CIELO;
- Arquivo para desistalação do plug-in configurado (uninstall.php);
- Função para tratamento inteligente de log adicionada.
Versão 1.3.0
- Implementação de suporte ao give-multimoedas;
- Adicionada configurações de depuração.
Versão 1.2.0
- Adicionado suporte a log de erros;
- Implementada compatibilidade com IonCube.
Versão 1.1.0
- Adicionada opção de captura automática ou manual;
- Correção de bug de valor incorreto em doações com decimais.
Versão 1.0.0
- Lançamento do plugin.
Precisa de ajuda?
A Link Nacional é uma companhia especializada em criar sites em WordPress e que também desenvolve plugins, tecnologias para sistemas de doação online, sistemas de pagamentos, WHMCS e outras soluções. Se está precisando de alguma solução para sistemas de doação entre em contato e peça uma consultoria gratuita.