VibeFox HyperPay for PrestaShop

Visão geral

O VibeFox HyperPay Payment Gateway adiciona ao PrestaShop pagamentos com cartão pelo widget COPYandPAY da HyperPay. Depois de confirmar o pedido na finalização da compra, o cliente vê o widget de pagamento da HyperPay em uma página de pagamento da sua loja e paga ali com VISA, Mastercard, mada, American Express, STC Pay ou Apple Pay. Os dados do cartão são digitados somente no widget da HyperPay e nunca chegam ao seu servidor. O pedido só é criado depois que a HyperPay confirma o pagamento, portanto pagamentos abandonados ou recusados não deixam pedidos sem pagamento.

Ele é indicado para lojas na Arábia Saudita, nos Emirados Árabes Unidos, na Jordânia, no Bahrein, em Omã, no Catar, no Egito e em outros mercados do MENA com uma conta de comerciante na HyperPay. O módulo não oferece reembolsos ou anulações pelo PrestaShop (faça-os no painel da HyperPay), cartões salvos, assinaturas, verificação de domínio do Apple Pay, uma entidade separada por bandeira nem métodos de compre agora e pague depois (buy now, pay later).

Principais recursos

Widget da HyperPay: o widget COPYandPAY na página de pagamento, carregado com Subresource Integrity, no idioma do cliente quando a HyperPay o oferece. Você escolhe quais bandeiras ele mostra.

Pago somente quando a HyperPay confirma: por uma consulta de status servidor a servidor quando o cliente volta, e por webhooks criptografados (AES-256-GCM) quando o navegador está fechado. A URL de retorno, sozinha, nunca cria um pedido pago.

Conferido com o carrinho: o pagamento precisa pertencer a uma das sessões de pagamento da HyperPay criadas para este carrinho, e o valor e a moeda precisam corresponder. Se não corresponderem, o pedido vai para HyperPay payment on hold com uma nota.

Sem processamento duplicado: cada resultado é aplicado uma única vez. Webhooks repetidos ou recarregamentos da página nunca criam um segundo pedido. Pagamentos duplicados, pagamentos recebidos após o cancelamento e estornos são registrados no pedido.

Débito ou pré-autorização: cobrar na hora, ou reservar o valor para capturá-lo depois com Capture payment no bloco da HyperPay no pedido.

Teste e produção: Access Token, Entity ID e chave de webhook separados para cada modo. Consultas de status, capturas e webhooks sempre usam o modo em que a sessão de pagamento foi criada.

Mensagens claras: pagamentos recusados, não concluídos ou ainda não confirmados são explicados ao cliente na finalização da compra, e o carrinho é mantido para uma nova tentativa.

Bloco da HyperPay na página do pedido: ID do pagamento, sessão de pagamento, valor, resultado e o botão de captura. Log sem dados de cartão, chaves ou dados do cliente.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior com a extensão OpenSSL. Uma conta de comerciante na HyperPay com Access Token e Entity ID (teste e produção) e um webhook de pagamento com sua chave de descriptografia. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).