VibeFox Hubtel for OpenCart

Visão geral

O VibeFox Hubtel Pay Gateway adiciona ao OpenCart 3 e ao OpenCart 4 pagamentos Hubtel em Gana. No último passo da finalização de compra, o cliente clica em Confirm Order, é enviado à página segura do Hubtel Online Checkout, paga com MTN MoMo, Telecel Cash, AirtelTigo Money, cartão Visa ou Mastercard ou GhQR, e volta à sua loja. O OpenCart cria o pedido antes do pagamento, mas o pedido só recebe um status depois que o Hubtel confirma o pagamento; por isso, tentativas não pagas permanecem como pedidos ausentes.

Ele é indicado para lojas ganenses que vendem em cedis ganeses (GHS) e têm uma conta empresarial no Hubtel. O Hubtel precisa incluir na lista de permissões o endereço IP do seu servidor web para a API de status de transações, e o Hubtel não tem um ambiente de testes público; por isso, todos os pagamentos são reais. A extensão não oferece reembolsos pelo OpenCart, assinaturas, cartões salvos nem a escolha do canal de pagamento dentro da loja.

Principais recursos

Finalização de compra hospedada pelo Hubtel: pagamentos por Mobile Money e cartão na página do Hubtel. O cliente escolhe lá o canal.

Pago somente quando o Hubtel confirma: os callbacks do Hubtel não são assinados, por isso a extensão nunca confia neles. Ela consulta a API autenticada de status de transações do Hubtel e só marca o pedido como pago quando o Hubtel informa Paid para o valor exato do pedido em GHS. Depois, o OpenCart envia os e-mails habituais do pedido.

Verificação do valor: um valor diferente coloca o pedido em um status de revisão à sua escolha, com uma observação.

Nada a configurar no Hubtel: a URL de callback é enviada com cada pagamento.

Callbacks perdidos cobertos: o retorno do cliente verifica o pagamento, uma URL de cron executa novas verificações em segundo plano, e você pode clicar em Check Hubtel payment status na página do pedido.

Sem processamento duplicado: cada tentativa de pagamento tem sua própria referência. Callbacks repetidos nunca aplicam um pagamento duas vezes nem reabrem um pedido cancelado. Antes de uma nova tentativa, as tentativas anteriores não confirmadas do mesmo carrinho são verificadas com o Hubtel, e um segundo pagamento de um pedido já pago é sinalizado para reembolso.

Aba do Hubtel na página do pedido: todas as tentativas de pagamento do pedido, com o status e a transação no Hubtel, além das observações do Hubtel.

Condições do OpenCart: zona geográfica, valor mínimo do pedido, ordem de exibição e os seus próprios status de pedido. Log opcional sem chaves de API nem dados de clientes.

Requisitos

OpenCart 3.0.x (testado com 3.0.5.0) ou OpenCart 4.0.2 e superior (testado com 4.1.0.3), PHP 8.0 ou superior com a extensão cURL. Um único download contém os pacotes das duas versões. Uma conta empresarial no Hubtel com API ID, API Key e número da conta de comerciante (POS Sales ID), e o IP do seu servidor incluído na lista de permissões pelo Hubtel. Moeda do pedido: cedi ganês (GHS). Recomenda-se um cron no servidor para as verificações em segundo plano. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).