Accept HyperPay (OPPWA) card payments in Odoo with the Copy&Pay widget, server-verified payment status, and one-click refunds for MADA, Visa and Mastercard.
HyperPay Payment Gateway lets your Odoo store accept card payments through HyperPay (OPPWA), using the Copy&Pay widget so customers pay by MADA, Visa or Mastercard inside your own Odoo payment page, with every payment confirmed by a server-side status check before the order is marked paid.
What it does
When a customer chooses HyperPay at checkout, the module creates a HyperPay checkout and loads the Copy&Pay widget directly in the Odoo payment page. The shopper enters their card and pays without being sent to a third-party screen. After the card is submitted, the module runs a server-to-server status request against HyperPay using the transaction's resource path, and it only marks the order paid when the confirmed amount, currency and merchant reference match the order. That means a returning browser or a replayed notification can never mark an order paid on its own. You configure everything on the provider record: enter your Entity ID and Access Token, choose Test for the sandbox or Enabled for production, and go.
Key features
- HyperPay (OPPWA) Copy&Pay widget embedded in the Odoo payment page, no external redirect
- MADA, Visa and Mastercard accepted through a single provider
- Server-to-server verification that matches amount, currency and reference before marking paid
- Full and partial refunds issued straight from the confirmed transaction
- Test and live handled by the provider state, targeting the sandbox and production endpoints
- Entity ID and Access Token stored as system-only fields, hidden from ordinary users
- Return URL and webhook handling so payment status is confirmed reliably
Who it's for
Merchants selling in Saudi Arabia and the Gulf who use HyperPay (OPPWA) and want to take MADA, Visa and Mastercard payments inside Odoo eCommerce, sales orders or invoices, with reliable server-verified confirmation and refunds handled in the same place.
Frequently asked questions
How do I accept HyperPay payments in Odoo?
Add HyperPay as a payment provider, enter your Entity ID and Access Token, and enable it. Customers then see the HyperPay Copy&Pay widget on the Odoo payment page and pay by card without leaving your checkout.
Does this support MADA cards in Odoo?
Yes. The Copy&Pay widget is configured for MADA, Visa and Mastercard, so Saudi shoppers can pay with their local MADA cards alongside international cards.
Is a HyperPay payment confirmed securely?
Every payment is confirmed by a server-to-server status request to HyperPay using the stored resource path. The returned amount, currency and merchant reference must match the order before it is marked paid, so a browser return alone can never confirm a payment.
Can I refund a HyperPay payment from Odoo?
Yes. Open the confirmed transaction and click Refund. You can refund the full amount or a partial amount, and the module sends the refund request to HyperPay and records the refund transaction against the original payment.
Does it have a test or sandbox mode?
Yes. Set the provider to Test to use the HyperPay sandbox endpoint with your test credentials, then switch to Enabled to go live on the production endpoint. No code change is needed.
Which Odoo versions does HyperPay Payment Gateway support?
Use the version selector at the top of this page to pick your Odoo release. Each Odoo Apps Store listing installs the build that matches that version.
Want this in your Odoo?
See the full feature list and screenshots, or talk to our certified Odoo team about setup and customization.