How do I connect HyperPay to my store?
HyperPay lets customers in Saudi Arabia pay online with mada, Visa, Mastercard, Apple Pay and STC Pay on a secure payment page. Each HyperPay account works in one currency (SAR, AED, QAR, EGP or USD) and shows at checkout only when your prices are in that currency.
Steps
- Get your credentials from HyperPay: an access token and one entity ID per payment group (Visa / Mastercard, mada and, if enabled, Apple Pay and STC Pay).
- In Dropify, go to Apps → Discover, find HyperPay and click Install.
- On the app page, click Connect HyperPay (or Add account), enter an Account name, paste the Access token and Entity ID (Visa / Mastercard), add the optional mada, Apple Pay and STC Pay entity IDs, choose the Account currency (SAR for Saudi accounts) and save. Dropify checks each entity with HyperPay.
- In the Settings card, choose Sandbox Mode with test credentials or Live Mode with live ones.
- Recommended: click Copy webhook URL, add it in HyperPay's dashboard and paste its decryption key into Webhook secret.
- Go to Store settings → Payment methods and switch HyperPay on. Optional: set a Discount for prepaid orders.
- Place a test order: the customer chooses mada, card, Apple Pay or STC Pay, then pays.
Only the methods you entered an entity ID for are offered to customers.
Common problems
- "HyperPay rejected these keys in test mode"the token or one entity ID belongs to the other environment. Use test credentials in Sandbox Mode.
- mada is missing on the payment pageadd the Entity ID (mada, optional); mada always has its own entity.
- HyperPay does not appear at checkoutyour store currency differs from the Account currency, the account is Inactive, or HyperPay is off in Payment methods.
- Orders stay unpaid when the customer closes the pageadd the webhook (step 5).