VibeFox Flutterwave for OpenCart

Visão geral

O VibeFox Flutterwave Payment adiciona ao OpenCart 3 e ao OpenCart 4 pagamentos pelo Flutterwave, através da página de pagamento hospedada do Flutterwave (Flutterwave Standard, API v3). No último passo da finalização de compra, o cliente clica em Confirm Order, é enviado à página do Flutterwave, paga com qualquer método habilitado na sua conta Flutterwave, como cartões, transferência bancária, USSD ou dinheiro móvel, e volta à sua loja. O OpenCart cria o pedido antes do pagamento, mas o pedido só recebe um status quando o Flutterwave confirma o pagamento, por isso as tentativas não pagas continuam como pedidos ausentes.

Ele é indicado para lojas na Nigéria, Gana, Quênia, África do Sul, África Oriental e Francófona, e para lojas que aceitam cartões internacionais. O pedido é sempre cobrado na moeda do pedido. A extensão aceita apenas pagamentos únicos. Não há finalização de compra integrada ou modal no seu site, nem cartões salvos, assinaturas, pagamentos divididos ou planos de pagamento, e os reembolsos feitos no painel do Flutterwave não são sincronizados com o OpenCart.

Principais recursos

Finalização hospedada: um pagamento é criado pelo total do pedido na moeda do pedido, arredondado para a precisão da moeda (XOF, XAF, UGX, RWF e outras não têm casas decimais). Você pode limitar as opções de pagamento exibidas na página do Flutterwave.

Pago somente quando o Flutterwave confirma: nem a URL de retorno nem o conteúdo do webhook são considerados confiáveis. Cada pagamento é consultado novamente no Flutterwave pelo seu servidor, e o pedido só é marcado como pago quando o status é bem-sucedido e o valor e a moeda conferem. Depois, o OpenCart envia os e-mails habituais do pedido.

Webhooks assinados: os webhooks são aceitos somente com o seu hash secreto. Eles confirmam o pagamento mesmo quando o cliente fecha o navegador.

Sem processamento duplo: webhooks e retornos repetidos nunca aplicam um pagamento duas vezes. Antes de uma nova tentativa, são verificados os pagamentos abertos do pedido e do carrinho; um link de pagamento antigo que seja pago depois continua sendo aceito, e um segundo pagamento de um pedido já pago é sinalizado para reembolso.

Métodos pendentes tratados: um pagamento por transferência bancária, USSD ou dinheiro móvel que ainda esteja pendente quando o cliente retorna deixa o pedido em um status de espera até que o Flutterwave o confirme.

Reembolsos pela página do pedido: reembolsos totais e parciais na aba VibeFox Flutterwave Payment do pedido, pelo valor e na moeda cobrados pelo Flutterwave, com a chave do modo em que o pagamento foi feito.

Teste e produção: chaves secretas separadas. Uma chave de teste em modo de produção, ou uma chave de produção em modo de teste, oculta o método de pagamento e exibe um aviso.

Configurações do OpenCart: seus próprios status de pedido, preenchimento automático opcional, zona geográfica, valor mínimo do pedido e ordem de exibição. Registro opcional, sem chaves nem dados de clientes.

Requisitos

OpenCart 3.0.x (testado na versão 3.0.5.0) ou OpenCart 4.0.2 e superior (testado na versão 4.1.0.3), PHP 8.0 ou superior. Um único download contém os pacotes para as duas versões. Uma conta Flutterwave com suas chaves secretas e um webhook com um hash secreto. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).