VibeFox Hubtel for PrestaShop

Visão geral

O VibeFox Hubtel Pay Gateway adiciona ao PrestaShop pagamentos via Hubtel em Gana. Na etapa de pagamento, o cliente escolhe o Hubtel, é direcionado para a página segura do Hubtel Online Checkout, paga com MTN MoMo, Telecel Cash, AirtelTigo Money, cartão Visa ou Mastercard ou GhQR e retorna à sua loja. O pedido só é criado depois que o Hubtel confirma o pagamento, portanto pagamentos abandonados não deixam pedidos sem pagamento.

Ele é indicado para lojas ganesas que vendem em cedis ganeses (GHS) e possuem uma conta comercial no Hubtel. O Hubtel precisa incluir na lista de permissões o endereço IP do seu servidor web para a Transaction Status API, e o Hubtel não possui ambiente de teste público, portanto todos os pagamentos são reais. O módulo não oferece reembolsos pelo PrestaShop, não suporta assinaturas, cartões salvos nem a escolha do canal de pagamento dentro da loja.

Principais recursos

Página de pagamento hospedada pelo Hubtel: pagamentos via Mobile Money e cartão na página do Hubtel. O cliente escolhe o canal diretamente lá.

Pago somente quando o Hubtel confirma: os callbacks do Hubtel não são assinados, portanto o módulo nunca confia neles. Ele consulta a Transaction Status API autenticada do Hubtel e cria o pedido como pago apenas quando o Hubtel informa o status "Paid" pelo valor total exato do carrinho em GHS.

Conferência do valor: um valor diferente coloca o pedido em Hubtel payment on hold, com uma nota para o gerente da loja.

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

Proteção contra callbacks perdidos: o retorno do cliente verifica o pagamento, uma URL de cron executa verificações em segundo plano e o gerente da loja 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 criam um segundo pedido nem reabrem um pedido cancelado ou reembolsado. Um segundo pagamento de um carrinho já pago é sinalizado para reembolso.

Cancelamento no Hubtel: o cliente volta à finalização de compra com uma mensagem e pode tentar novamente. O carrinho é mantido.

Bloco do Hubtel na página do pedido: todas as tentativas de pagamento do pedido com seu status e transação no Hubtel, além das notas do Hubtel. Log opcional sem chaves de API ou dados dos clientes.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior com a extensão cURL. Uma conta comercial 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 do Hubtel. Moeda da loja: 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).