VibeFox Pesapal for OpenCart

Visão geral

O VibeFox Pesapal Pay Gateway adiciona ao OpenCart 3 e ao OpenCart 4 pagamentos pela Pesapal. A extensão se conecta à API 3.0 da Pesapal. No último passo da finalização de compra, o cliente clica em Confirm Order, é enviado para a página de pagamento da Pesapal e paga com M-Pesa, Airtel Money, MTN, cartão, transferência bancária ou outro método que a Pesapal oferece no país do cliente. Os dados do cartão nunca passam pela sua loja. O OpenCart cria o pedido antes do pagamento, mas o pedido só recebe um status quando a Pesapal confirma o pagamento, então as tentativas não pagas continuam sendo pedidos ausentes.

Ela é indicada para lojas no Quênia, Uganda, Tanzânia, Ruanda, Zâmbia, Malawi e Zimbábue que vendem em KES, UGX, TZS, ZMW, RWF ou USD e têm uma conta de comerciante na Pesapal. Só são necessários a consumer key e o consumer secret. A extensão não faz reembolsos pela página do pedido (faça o reembolso no painel da Pesapal), não salva cartões, não tem assinaturas nem pagamentos recorrentes, não tem formulário de pagamento no seu próprio site e não faz conversão de moedas.

Principais recursos

Pago somente quando a Pesapal confirma: as notificações da Pesapal e o retorno do cliente não trazem dados de pagamento, então a extensão nunca confia neles. Sempre que necessário, ela pede à Pesapal o status da transação por meio de uma requisição autenticada de servidor para servidor. Depois disso, o OpenCart envia os e-mails de pedido habituais.

Verificação de valor e moeda: o pedido só é marcado como pago quando a Pesapal informa Completed e o valor e a moeda pagos coincidem com o pedido. Se houver divergência, o pedido vai para um status de análise com uma nota.

Configuração automática do IPN: a URL de notificação é registrada na Pesapal no primeiro pagamento, separadamente para sandbox e produção. Nada precisa ser configurado no painel da Pesapal.

Sem processamento duplicado: notificações repetidas e uma notificação que chega junto com o retorno do cliente nunca aplicam um pagamento duas vezes. Pedidos cancelados e reembolsados nunca são reabertos, e um segundo pagamento para um pedido ou carrinho já pago é sinalizado para reembolso.

Cada tentativa fica registrada: um pagamento feito em uma página anterior da Pesapal do mesmo carrinho, por exemplo em uma segunda aba do navegador, continua sendo reconhecido, e uma nova tentativa verifica primeiro as anteriores.

Modos sandbox e produção: chaves separadas para cada modo. Um pagamento é sempre verificado no modo em que foi iniciado.

Seus próprios status de pedido: escolha o status do OpenCart para um pedido pago, um pagamento em análise, um pedido cancelado e um pagamento estornado. Um pagamento que a Pesapal informa como estornado coloca o pedido pago como Refunded.

Aba da Pesapal na página do pedido: ID de rastreamento, referência do comerciante, modo, status na Pesapal, método de pagamento, código de confirmação, todas as tentativas de pagamento e notas. Zona geográfica, valor total mínimo e ordem de classificação do OpenCart. Log opcional sem chaves, tokens ou dados de clientes.

Requisitos

OpenCart 3.0.x (testado na versão 3.0.5.0) ou OpenCart 4.0.2 e posteriores (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 de comerciante na Pesapal com a consumer key e o consumer secret (sandbox e/ou produção). Sua loja precisa estar acessível pela internet para receber as notificações de pagamento. Moeda do pedido: KES, UGX, TZS, ZMW, RWF ou USD. Uma chave de licença do VibeFox obtida em vibefox.net (uma chave por domínio).