VibeFox Pesapal for PrestaShop

Visão geral

O VibeFox Pesapal Pay Gateway adiciona pagamentos Pesapal ao PrestaShop. Ele se conecta à API 3.0 da Pesapal. Na etapa de pagamento, o cliente escolhe a Pesapal, é direcionado 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 oferecido pela Pesapal no país do cliente. Os dados do cartão nunca passam pelo seu site. O pedido só é criado depois que a Pesapal confirma o pagamento, então pagamentos abandonados não deixam pedidos sem pagamento.

É indicado 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árias a chave e o segredo do consumidor. O módulo não oferece reembolsos pela página do pedido (o reembolso é feito no painel da Pesapal), cartões salvos, assinaturas ou pagamentos recorrentes, formulário de pagamento no seu próprio site nem conversão de moeda.

Principais recursos

Pago somente quando a Pesapal confirma: as notificações da Pesapal e o retorno do cliente não contêm dados de pagamento, por isso o módulo nunca confia neles. Sempre que necessário, ele consulta o status da transação na Pesapal por meio de uma requisição autenticada entre servidores.

Verificação de valor e moeda: o pedido só é marcado como pago quando a Pesapal informa que o pagamento foi concluído e o valor e a moeda pagos correspondem ao carrinho. Uma divergência coloca o pedido em Pesapal payment on hold com uma nota.

Configuração automática do IPN: a URL de notificação é registrada na Pesapal no primeiro pagamento, separadamente para teste 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 criam um segundo pedido. Pedidos cancelados e reembolsados não são reabertos, e um segundo pagamento de um pedido já pago é sinalizado para reembolso.

Cada tentativa é lembrada: um pagamento feito em uma página anterior da Pesapal do mesmo carrinho, por exemplo em outra aba do navegador, também é reconhecido.

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

Estornos: um pagamento que a Pesapal informa como estornado muda o pedido pago para Refunded.

Bloco de pagamento 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 as notas. Registro opcional, sem chaves, tokens ou dados de clientes.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior. Uma conta de comerciante na Pesapal com a chave e o segredo do consumidor (teste e/ou produção). Sua loja precisa estar acessível pela internet para receber as notificações de pagamento. Moeda do carrinho: KES, UGX, TZS, ZMW, RWF ou USD. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).