CODEerts
Accounting app for Odoo
HyperPay Payment Gateway
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.
Overview
HyperPay Payment Gateway.
HyperPay Payment Gateway connects your Odoo checkout to HyperPay (OPPWA) using the Copy&Pay payment widget. Customers pay by MADA, Visa or Mastercard inside your Odoo payment page, and every payment is confirmed by a server-to-server status check whose amount, currency and reference must match the order before it is marked paid. Issue full or partial refunds straight from the transaction, switch between test and live with the provider state, and keep credentials protected as system-only fields.
New to Odoo Accounting? Read our practical guide to how it works
How it works
Built around what you actually do.
Every screen below is the module running in Odoo, not a mockup.
01
HyperPay (OPPWA) Copy&Pay widget embedded in the Odoo payment page
- Accept MADA, Visa and Mastercard cards
- Server-to-server status verification that matches amount, currency and reference before marking paid
02
Full and partial refunds issued directly from the transaction
- Test and live modes driven by the provider state, with sandbox and production endpoints
- Entity ID and Access Token stored as system-only credential fields
03
Return URL and webhook handling for reliable payment confirmation
Every screen
The whole module, screen by screen.
The captures the walkthrough above did not use, in the order you meet them in the product.
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.
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.
Proven in production
Not just published.
This module came out of real client work. Here is the engagement it was built in.
Questions
About HyperPay Payment Gateway.
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.
On the Odoo Store
Get HyperPay Payment Gateway on the Odoo Store.
Pick your Odoo version and install it in a click, with free updates and real support behind it.
Get it on the Odoo StoreReady to make Odoo work the way your business does?
Book a free call
CODEerts
CODEerts is a team of certified Odoo partners and full-stack engineers. We implement, customise and support Odoo ERP, then build the software around it.
