Geral


Introdução

É com muita satisfação que apresentamos o nosso serviço de método de pagamento. Aqui você aprenderá a integrar qualquer aplicação em Javascript com o nosso ecossistema global de impacto. A partir disso, conseguirá executar pagamentos 100% dentro da sua própria plataforma. Pra isso, você precisará seguir os passos abaixo. Não é difícil. Com um pouco de conhecimento em programação, você será capaz de cobrar via cartão de crédito e atualizar o status delas no seu próprio site.

Para iniciar essa jornada, você precisa de um API Key, ou seja, precisa cadastrar a sua iniciativa na Welight e conectá-la via chave. Em seguida, deverá instalar a biblioteca que preparamos para conectar automaticamente a sua aplicação. Em seguida, basta usar os Endpoints pra se conectar ao nosso serviço.




Obtendo o API Key

Faça login com o seu usuário em welight.live/login e selecione a ferramenta Vender Doando no menu de ferramentas

Clique em Nova iniciativa, na página de Iniciativas e selecione a opção Gateway no campo Tipo de iniciativa

Vá até o painel da sua iniciativa clicando no seu card e pronto, sua credencial será exibida para você.

Integração manual


Instalando o Welight.js

Primeiro, você precisa posicionar o objeto (div com id WelightGateway_checkout) no seu site, na página de pagamento. Pra isso, você deve utilizar o seguinte objeto:

<div id="WelightGateway_checkout"></div>

Em seguida, deve chamar a biblioteca da Welight.js (1kb):

<script src='https://welight.live/libs/global_scripts/welight.js'></script>

E então, você precisa identificar o seu usuário, colocando a sua API Key, no seguinte script:

<script>WelightGateway_setAccountID("DIGITE_AQUI_O_SEU_APIKEY");</script>




Uso de parâmetros

Para concluir uma venda, você precisa enviar os dados da compra através dos parâmetros na URL para a página onde foi instalado o Welight.js. A Welight vai pegar os parâmetros da URL e os dados de pagamento do cliente e processar o pagamento.

Os parâmteros esperados são:

Nome do parâmetro Valor esperado Valor inicial
welight_nome
string
 Este parâmetro espera o nome do comprador. null
welight_email
string
 Este parâmetro espera o email do comprador. null
welight_total
number
 Este parâmetro espera o valor total da compra. null
welight_desc
string
 Este parâmtero espera a descrição da compra. null
welight_custom
string 		A Welight oferece este espaço para você registrar um valor chave.




Webhook

A Welight oferece esta opção para que você atualize o status das faturas na sua aplicação sem você precisar vir buscar estes dados. Você receberá os dados no formato JSON e precisa ter um arquivo para receber estes dados propriamente. A ideia é você criar um arquivo no seu servidor que recebe uma requisição da Welight, toda vez que o status de uma fatura é alterado. Você vai precisar de um script que, além de capturar os parâmetros enviados pela Welight, seja capaz de alterar o status da fatura no seu sistema. Com ele na mão, basta informar nas configurações da sua iniciativa, no campo URL de atualização de status.

Welight para Wordpress


Woocommerce

O primeiro passo é instalar a loja virtual do Woocommerce. Se você já tem uma loja Woocommerce instalada, vá para o próximo passo. Caso tenha outra loja, você pode se integrar manualmente ou entrar em contato com o nosso time para que possamos compreender a sua necessidade e bolarmos uma solução juntos.




Instalando o plugin da Welight

Primeiro, você precisa obter o plugin da Welight. Você pode fazer o download na aba Plugins da área administrativa Wordpress do seu site, ou você pode baixar o plugin e instalar manualmente. Para realizar a instalação manual, basta colar a pasta do plugin dentro do seguinte caminho.

../wp-content/plugins

Uma vez instalado, agora você precisa ativá-lo ainda na aba Plugins da área administrativa Wordpress do seu site.




Configuração

Primeiro você precisa obter a API Key. Em seguida, copie e cole a sua API Key no campo Chave de autorização, localizado na aba Welight, dentro das configurações do seu Woocommerce.

Neste momento, você deve configurar o quanto irá doar a cada venda, editar a mensagem que aparecerá para os seus clientes e outras opções de configuração. Por fim, clique na aba Pagamentos e habilite o método Welight Gateway. E estamos prontos para realizar a sua primeira compra/venda.