Descrizione
O Galax Pay WooCommerce oferece uma solução completa para pagamentos com cartão de crédito e boleto utilizando o Woocommerce. Basta ter uma conta no GalaxPay e o módulo de WebService ativado, para começar a cobrar seus clientes.
Observações
O Galax Pay é um sistema de pagamento recorrente, com milhares de clientes.
Requisitos
- PHP versão 5.6.x ou superior.
- Um site com o WordPress instalado.
- Plugin WooCommerce instalado e habilitado.
- Plugin WooCommerce Extra Checkout Fields for Brazil instalado e habilitado.
- Conta ativa no Galax Pay.
- Caso vá utilizar o modo de recorrência (assinatura), se torna obrigatória a instalação do plugin WooCommerce Subscriptions.
Detalhes de funcionamento
Mudança de status de um pagamento dentro do WordPress:
Caso for o pagamento de uma assinatura, não será refletido no Galax Pay.
Caso for o pagamento único de uma venda:
Se o status ser alterado para “Cancelado” ou “Falhado”, a venda será cancelada no Galax Pay.
Se o status ser alterado para “Concluído” a venda será alterada para “paga fora do sistema” no Galax Pay.
Assinatura:
A recorrência de uma assinatura é controlada pelo Galax Pay, as transações já serão cadastradas no sistema, de acordo com a periodicidade da assinatura.
Caso utilizar taxa de ativação numa assinatura, o valor será cobrado numa primeira transação.
Caso utilizar período grátis numa assinatura, as transações da mesma serão cadastradas com a data de vencimento após o término do período gratuito.
Fluxo ao criar uma assinatura no WordPress:
Será criado um contrato no Galax Pay, de acordo com a periodicidade do mesmo (ex: semanal, mensal, etc…).
Caso seja uma assinatura que tenha período definido (ex: 12 meses), já serão criados todos os pagamentos no Galax Pay. Alterações realizadas dentro de um pagamento específico dessa assinatura no Galax Pay não serão refletidas no WordPress.
Caso seja uma assinatura indeterminada (sem data de término), será criado apenas o primeiro pagamento no Galax Pay, já os demais serão criados nos períodos sequentes.
Fluxo dentro do wordpress:
Assim que o usuário realizar uma assinatura, ela ficará com o status “Pendente”. Além disso, será criado um pedido, que ficará com o status “Pagamento pendente”.
Mudança de status:
Pagamento da primeira transação realizado com sucesso:
Status do pedido = Concluído
Status da assinatura = Ativa
Pagamento da primeira transação negado / não realizado:
Status do pedido = Falhado
Status da assinatura = Em espera
Ao estornar uma transação pelo Galax Pay:
Status do pedido: Reembolsado
Status da assinatura: Cancelada
Pagamento das demais (após a primeira) transações de uma assinatura:
Toda vez que uma tentativa de cobrança é realizada pelo Galax Pay, será criado um pagamento de renovação dentro do WordPress, vinculado a assinatura atual. O “Id para integração” dessa transação no Galax Pay será o Id do novo pagamento no WordPress.
Caso a tentativa seja aprovada:
O novo pedido ficará com o status de “Concluído” e a assinatura “Ativa”. Na assinatura a data do próximo pagamento será alterada de acordo com a periodicidade do contrato.
Caso a tentativa seja negada / não realizada:
O novo pedido ficará com o status de “Falhado” e a assinatura “Em Espera”.
OBS: Sempre que o status de uma transação for alterado no Galax Pay, tanto na assinatura como no pedido será inserido uma nota, informando sobre o status desse pagamento.
OBS: Dentro do novo pedido no WordPress, serão adicionados 3 campos personalizados:
galaxCustomerId -> Número do cliente no Galax Pay
galaxPayBill -> Número do contrato no Galax Pay
galaxPayTransaction -> Número da transação que este pedido é referente
OBS: É possível criar assinatura com produtos simples, utilizando o plugin “Subscriptions Add-On for WooCommerce”. Utilizando esse plugin, ele sobrescreverá o fluxo normal realizado pelo plugin do Galax Pay, assim o pedido, ao ser criado no WordPress, ficará com o status “Em processamento” e a assinatura “Em espera”.
Fluxo ao criar uma venda no WordPress:
Ao realizar a venda de um “Produto Simples”, será criada uma venda no Galax Pay respeitando a forma de pagamento selecionada. No WordPress será criado um pedido, com o status “Pagamento pendente”.
Mudança de status:
Pagamento da transação realizado com sucesso:
Status do pedido = Concluído
Pagamento da transação negado / não realizado:
Status do pedido = Falhado
Ao estornar a transação pelo Galax Pay:
Status do pedido = Reembolsado
OBS: Em ambos casos, no pedido será inserida uma nota, informando sobre o status do pagamento.
Informações adicionais:
Possíveis status de transação para confirmação do pagamento:
payedPix (Pix pago), payedBoleto (Boleto compensado), captured (Capturada na Operadora) e payExternal (Paga fora do sistema).
Possíveis status de transação para pagamento negado / não realizado:
unavailablePix (Pix Indisponível para pagamento), notCompensated (Boleto baixado por decurso de prazo) e denied.
Ao realizar o cancelamento de uma venda ou assinatura manualmente no Galax Pay, será refletido no WordPress.
Configurações dentro do Galax Pay:
– Ter o módulo de WebService ativo
– Dentro do módulo de WebService, ter ativo: API V2 e transaction.updateStatus
– Inserir o IP no site na Whitelist de IP do módulo Webservice
– URL do Webhook:
/wc-api/galax_pay_webhook/
dominio.com.br/wc-api/galax_pay_webhook/
Limitações:
- Dentro do painel do administrador, nos pedidos, apenas alterações de status serão realizadas. Demais alterações como valores, taxas, cupons, deverão ser realizadas dentro da plataforma Galax Pay.
- Caso uma transação seja criada manualmente no Galax Pay, ela não será refletida corretamente no WordPress.
- Não cancele transações manualmente de uma assinatura no Galax Pay.
- Só é possível realizar a compra de um produto de assinatura por vez.
License
Galax Pay WooCommerce is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation.
Galax Pay WooCommerce is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
Installazione
- Envie os arquivos do plugin para a pasta wp-content/plugins, ou utilize o instalador de plugins do WordPress.
- Ative o plugin.
Configuração
- Copie o GalaxId e GalaxHash que estão localizados no Galax Pay em Módulos -> Webservice -> Configurar módulo;
- De volta no WooCommerce, cole as credenciais na página administrativa do plugin WooCommerce -> Configurações -> Galax Pay;
- Após salvar as credenciais, copie a URL que consta na página administrativa e cole no Galax Pay em Módulos -> Webservice -> Configurar módulo -> URL Webhook
- De volta no WooCommerce -> Configurações -> Finalizar Compra, ative as opções desejadas: Cartão de crédito / Boleto Bancário / Pix.
- Em WooCommerce -> Campos do Checkout, ative Tipo de Pessoa Física e Jurídica e Telefone Celular.
- Em WooCommerce -> Configurações -> Subscriptions, ative a opção “Accept Manual Renewals, ative a opção “Turn off Automatic Payments” e clique em Salvar alterações.
Para mais detalhes sobre a instalação de plugins no WordPress leia o tutorial WordPress – Gerenciando Plugins.
Recensioni
Contributi e sviluppo
“Galax Pay WooCommerce” è un software open source. Le persone che hanno contribuito allo sviluppo di questo plugin sono indicate di seguito.
Collaboratori
Traduci “Galax Pay WooCommerce” nella tua lingua.
Ti interessa lo sviluppo?
Esplora il Codice segui il Repository SVN iscriviti al Log delle Modifiche. Puoi farlo tramite RSS con un lettore di feed.
Changelog (registro delle modifiche)
1.0 – 10/01/2020
- Primeira versão lançada.
2.0 – 17/02/2020
- Adicionada recorrência no cartão de crédito através do Woocommerce Subscriptions.
4.0 – 12/11/2021
- Adicionado Pix como nova forma de pagamento.
- Alterações / melhorias gerais nos fluxos de assinatura / venda.
4.1 – 25/11/2021
- Correção no fluxo de configuração da integração pela primeira vez.
4.2 – 28/11/2021
- Correção no fluxo de assinatura, utilizando período grátis e taxa de ativação.
- Implementação de funcionalidade para escolher o status do Pedido quando houver um pagamento realizado com sucesso.
4.3 – 10/01/2022
- Correção em fluxo específico no pagamento negado da transação de uma assinatura que a primeira transação foi paga.
4.4 – 07/02/2022
- Quando um pedido com o pagamento em cartão ser negado, o mesmo ficará com o status de “Falhado”.
4.5 – 15/02/2022
- Opção na configuração para atualizar o token de segurança do Webhook.
4.6 – 16/02/2022
- Quebrar campos de mês e ano em resolução mobile, no checkout de cartão de crédito.
4.7 – 07/03/2022
- Opção para desabilitar myId do cliente na integração ao criar pagamentos.
4.8 – 18/08/2022
- Tratamento para alterações de pedidos sem o plugin de assinatur estar ativo.
4.9 – 12/04/2023
- Tratamento para retentativas de pedidos de uma assinatura e ajuste na sessão.
5.0 – 04/05/2023
- Tratamento para evitar duplicação de pedidos ao receber webhook.