# 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

1. 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).
2. In Dropify, go to **Apps → Discover**, find **HyperPay** and click **Install**.
3. 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.
4. In the **Settings** card, choose **Sandbox Mode** with test credentials or **Live Mode** with live ones.
5. Recommended: click **Copy webhook URL**, add it in HyperPay's dashboard and paste its decryption key into **Webhook secret**.
6. Go to **Store settings → Payment methods** and switch **HyperPay** on. Optional: set a **Discount for prepaid orders**.
7. 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 page → add the **Entity ID (mada, optional)**; mada always has its own entity.
- HyperPay does not appear at checkout → your 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 page → add the webhook (step 5).

## Related
- [How do I connect Moyasar to my store?](https://help.dropify.shop/en/payments_gateways/moyasar/)
- [How do I connect Geidea to my store?](https://help.dropify.shop/en/payments_gateways/geidea/)
