Skip to content

HyperPay with Wameed POS: mada, Visa and Mastercard online, on your own HyperPay account

Wameed POS connects to your own HyperPay merchant account for web-store orders, payment links, pay-at-table and kiosk payments. Customers pay on a secure HyperPay card form, HyperPay settles to your bank, and every payment is confirmed before an order is marked paid. No Apple Pay or STC Pay here.

By The Wameed teamWameed POS

4 min read

Wameed POS connects to HyperPay. Customers pay on a secure HyperPay card form withmada, Visa and Mastercard,HyperPay settles to your bank, notifications are encrypted and verified with a secret only the branch holds, and refunds (full or partial) go back to the original card from Wameed. Every plan; about 15 minutes once HyperPay gives you credentials.Reviewed November 2026.

What the HyperPay integration does

  • Online card payments forweb-store orders, payment links, pay-at-table and the kiosk.
  • Visa, Mastercard and mada, with an optional separate mada entity ID and a choice of which brands your Entity ID takes.
  • Encrypted payment notifications (webhook type PAYMENTS) verified with a 64-character secret generated for the branch.
  • Full and partial refunds to the original card from Wameed (a supervisor’s approval is needed); a full refund HyperPay does not allow yet, for example the same day, is reversed instead.

What you need

  • A HyperPay merchant account with test credentials (HyperPay issues them, and live ones after your integration is checked).
  • A portal user who can seeAdministration → Account data andAdministration → Webhooks.
  • Youraccess token and one or moreEntity IDs (one per payment channel); Test and Live are separate (hosts eu-test.oppwa.com and eu-prod.oppwa.com).

Set up in 5 steps

  1. Get your credentials from HyperPay; to go live ask your HyperPay account manager.
  2. In the HyperPay portal for that environment openAdministration → Account data → Merchant / Channel Info and copy the access token and the Entity ID of the channel that takes Visa and Mastercard.
  3. In Wameed choose Sandbox (Test) or Production (Live), paste the token and Entity ID, add the mada Entity ID if you have one, choose the brands, and select Connect; Wameed checks them by looking up an order that does not exist.
  4. In the portal openAdministration → Webhooks, add a webhook with the URL Wameed shows, type PAYMENTS, fields ALL, and the 64-character secret as the Secret; save and select “Click to Test” — a new webhook stays inactive until the test passes.
  5. On Test, pay with HyperPay’s test cards (Visa 4200 0000 0000 0000, Mastercard 5454 5454 5454 5454, any 3-digit CVV and a future expiry); ask HyperPay for mada test cards.

What to know — and what it does not do

  • Apple Pay and STC Pay are not offered through this connection.
  • The notification address isoptional but recommended: without it a payment is still confirmed when the shopper returns and by a periodic check — just later; a refund made in the portal is noticed only through it.
  • HyperPay’s servers only call addresses with avalid, trusted certificate; add and test the webhook on Test first.
  • If you rotate the secret, paste the new one into the HyperPay webhook straight away or notifications are refused.
  • mada payments are authenticated with 3-D Secure, and the form asks the shopper for the billing address 3-D Secure needs.
  • One gateway at a time: connecting HyperPay turns off EdfaPay, Moyasar or PayTabs on that branch.

Where it fits in Wameed

HyperPay suits merchants who already have a HyperPay agreement or whose bank works through it. Branches of one HyperPay account can share a webhook as long as they use the same access token and an entity ID in common. For the other gateways seeEdfaPay,Moyasar andPayTabs; for the store that uses them, see thebest online store.

More answers

All integrations ·mada fees explained ·Best cashier

Frequently asked questions

Does HyperPay work with Apple Pay in Wameed?

No. Apple Pay and STC Pay are not offered through the HyperPay connection.

What is an Entity ID?

A HyperPay identifier for a payment channel. You may have one for Visa and Mastercard and a separate one for mada.

Do I need the webhook?

It is optional but recommended: without it payments are confirmed later and portal refunds are not noticed.

Which plans include HyperPay?

Every plan.

  • #هايبر باي
  • #بوابة دفع
  • #مدى وفيزا وماستركارد
  • #3-D Secure
  • #HyperPay integration
  • #HyperPay Wameed POS
  • #OPP payment gateway Saudi Arabia
  • #card payments entity ID

Share this article

Ask about your own shop

Thirty minutes on your products, your tax setup and your hardware — not a slide deck.

Keep reading