| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 619 |
| Technical Name |
am_payment_hyperpay |
| License | OPL-1 |
| Website | https://idealitsetup.com/ |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 619 |
| Technical Name |
am_payment_hyperpay |
| License | OPL-1 |
| Website | https://idealitsetup.com/ |
HyperPay Payment Provider for Odoo
Native HyperPay (OPPWA) integration with VISA, MasterCard, MADA & 3-D Secure 2.
Overview
HyperPay Payment Provider brings the OPPWA gateway natively into Odoo's
standard payment framework. It handles the full Server-to-Server
card flow including 3-D Secure 2 challenges, refunds, and MADA-compliant
checkout for Saudi Arabia and the GCC.
Use Case: Merchants based in Saudi Arabia, the UAE, or the wider MENA region who use HyperPay/OPPWA to accept local card payments — especially MADA — directly inside Odoo eCommerce, Sales, Invoicing, or any module that uses
payment.transaction.
Key Features
| ✔ Server-to-Server Card Payments — VISA, MasterCard, MADA, AMEX. |
| ✔ 3-D Secure 2 Redirect Flow — redirect, return URL, and status query handled fully automatically. |
| ✔ Refunds — full or partial, from any confirmed transaction. |
| ✔ Pre-Authorization (PA) or Direct Debit (DB) — switchable per provider. |
| ✔ Multi-Currency — SAR, AED, USD, EUR, EGP, KWD, BHD, QAR, OMR, JOD. |
| ✔ Stylish Card Modal — auto-formatted MM/YY field, brand detection, MADA/Visa/MasterCard logo swap. |
✔
Auto Customer & Billing Data — fetched from res.partner
(email, name, address, country in ISO Alpha-2).
|
✔
Test Sandbox Switch — testMode=EXTERNAL and
3DS2_enrolled=true are added automatically when the
provider is in test state.
|
How It Works
| Step 1: Install the module — the HyperPay provider record is created automatically and linked to the standard Card, VISA, MasterCard and MADA payment methods. |
| Step 2: In Accounting / Website → Configuration → Payment Providers open HyperPay, paste your Entity ID and Access Token from the OPPWA back-office, choose DB or PA, and switch state to Test or Enabled. |
Step 3:
The shopper picks HyperPay at checkout, fills the styled card modal,
and the module performs POST /v1/payments with all required
parameters (customer, billing, 3DS).
|
Step 4:
For 3-D Secure transactions the shopper is redirected to the bank's
challenge page; on return the module queries
GET /v1/payments/{id} and finalizes the Odoo transaction.
|
Step 5:
From any captured payment, an admin can issue a refund — the module
sends paymentType=RF to HyperPay and reflects it in the
Odoo records.
|
Screenshots
Test Cards (Sandbox)
| Brand | Card Number | Expiry | CVV | Result |
|---|---|---|---|---|
| VISA | 4012 0000 3333 0026 |
01/39 | 100 | Success |
| MasterCard | 5123 4500 0000 0008 |
01/39 | 100 | Success |
| MADA | 4464 0400 0000 0007 |
11/25 | 850 | Success |
Technical Information
| Attribute | Value |
|---|---|
| Technical Name | payment_hyperpay |
| Version | 17.0.1.0.0 |
| Dependencies | payment |
| License | OPL-1 |
| Test Endpoint | https://eu-test.oppwa.com |
| Production Endpoint | https://eu-prod.oppwa.com |
Contact & Support
$150 USD
One-time purchase — lifetime free updates within Odoo 17.
Includes professional support and customization on request.
| Developer: | Ahmed Magdy |
| Email: | qarsan4@gmail.com |
| Website: | idealitsetup.com |
| WhatsApp: | +966 50 981 8413 |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module