VibeFox HyperPay for PrestaShop

Overview

VibeFox HyperPay Payment Gateway adds card payments through the HyperPay COPYandPAY widget to PrestaShop. After confirming the order at checkout, the customer sees the HyperPay payment widget on a payment page of your shop and pays there with VISA, Mastercard, mada, American Express, STC Pay or Apple Pay. Card data is entered only in the HyperPay widget and never touches your server. The order is created only after HyperPay confirms the payment, so abandoned or declined payments leave no unpaid orders.

It suits shops in Saudi Arabia, the UAE, Jordan, Bahrain, Oman, Qatar, Egypt and other MENA markets with a HyperPay merchant account. The module has no refunds or voids from PrestaShop (make them in the HyperPay dashboard), no saved cards, no subscriptions, no Apple Pay domain verification, no separate entity per brand and no buy-now-pay-later methods.

Key features

HyperPay widget: the COPYandPAY widget on the payment page, loaded with Subresource Integrity, in the customer's language when HyperPay supports it. You choose which brands it shows.

Paid only when HyperPay confirms: by a server-to-server status request when the customer returns, and by encrypted webhooks (AES-256-GCM) when the browser is closed. The return URL alone never creates a paid order.

Checked against the cart: the payment must belong to one of the cart's own checkouts, and the amount and currency must match. A mismatch puts the order in HyperPay payment on hold with a note.

No double processing: each result is applied once. Repeated webhooks or page reloads never create a second order. Duplicate payments, payments after cancellation and reversals are noted on the order.

Debit or pre-authorization: charge at once, or reserve the amount and capture it later with Capture payment in the HyperPay block of the order.

Test and live: separate Access Token, Entity ID and webhook key for each mode. Status checks, captures and webhooks always use the mode in which the checkout was created.

Clear messages: declined, not completed or not yet confirmed payments are explained to the customer at checkout, and the cart is kept for another try.

HyperPay block on the order page: payment ID, checkout, amount, result and the capture button. Log without card data, keys or customer data.

Requirements

PrestaShop 8.0 to 9.x, PHP 8.0 or later with the OpenSSL extension. A HyperPay merchant account with Access Token and Entity ID (test and live), and a payment webhook with its decryption key. A VibeFox license key from vibefox.net (one key per domain).