Moamalat LightBox Payment Gateway Integration - Secure Online Payments (Odoo18)

Integrate Moamalat LightBox payment gateway directly into Odoo 18. Accept seamless and secure online payments using Merchant ID, Terminal ID, and Secret Key. Fully integrated with Odoo's default payment system.

It allows businesses to accept secure online payments from customers during checkout using Moamalat's LightBox popup interface. No custom payment code or manual transaction handling is required.

Our module uses Odoo native payment.provider and payment.transaction logic.

The integration supports:
• Live checkout using LightBox popup
• Automatic transaction creation
• Callback handling (success, cancel, error)
• Provider Reference mapping
• Logging Moamalat fields (SystemReference, NetworkReference, PayerName, Account, TxnDate)
• Backend transaction visibility
• Fully compatible with Odoo eCommerce & Invoices

This module is ideal for businesses, needing a secure, modern, compliant, and fast online payment solution inside Odoo.

Key Features

• Complete Moamalat LightBox Integration:Native and seamless integration using Odoo's default payment framework.
• Works with Odoo eCommerce & Portal Payments:Supports Website Checkout + Customer Portal "Pay Now".
• No Manual Controllers:Uses Odoo's built-in /payment/* routes.
• Automatic Callback Processing:Pop-up return callback sends payment confirmation to Odoo automatically.
• Additional Moamalat Fields Stored in Transaction:
  • System Reference
  • Network Reference
  • Payer Account
  • Payer Name
  • Transaction Date
• Provider Reference Auto-Updated:Odoo's standard provider_reference is filled with SystemReference.
• SHA-256 Secure Hash Implementation (as per Moamalat docs)
• Clean, simple LightBox popup:Popup stays stable when clicking the Pay button.
• Extremely easy to configure:Only requires MID, TID, Secret Key.

Configuration

• STEP 1 - Install the App:Go to: Apps > Moamalat LightBox Payment Provider > Install
• STEP 2 - Set the Payment Provider:Go to: Website > Configuration > Payment Providers and Select: Moamalat LightBox
• STEP 3 - Enter Your Credentials:In the "Credentials" tab, fill:
  • Merchant ID (MID) - Provided by Moamalat
  • Terminal ID (TID) - Provided by Moamalat
  • Secret Key (Hex) - Provided by Moamalat
  
• STEP 4 - Enable the Provider:Set State = Enabled and choose environment as Test or Production
• STEP 5 - Activate Payment Method:
  
• STEP 6 - Test the Flow:Go to website > Place an order > Select Moamalat LightBox > Pay.
  
• STEP 6 - Test the Flow:A Popup appears > Enter info > Payment success > Redirect to Odoo.
  

API DOCUMENTATION SUMMARY (From Moamalat LightBox Docs)

Based on: https://docs.moamalat.net/lightBox.html

• STEP 1 - Payment Request Fields:The module sends the required fields
  • MID
  • TID
  • AmountTrxn
  • MerchantReference
  • TrxDateTime
  • SecureHash (SHA256)
• STEP 2 - Hash Generation Rule
• STEP 3 - LightBox Checkout Config:

                                      window.Lightbox.Checkout.configure({
                                      MID,
                                      TID,
                                      AmountTrxn,
                                      MerchantReference,
                                      TrxDateTime,
                                      SecureHash,
                                      completeCallback,
                                      cancelCallback,
                                      errorCallback
                                  });
                              

• STEP 4 - Callback Data Returned by Moamalat:Module supports:
  • SystemReference
  • NetworkReference
  • PayerAccount
  • PayerName
  • TxnDate
  • SecureHash returned
• STEP 5 - WHERE CREDENTIALS COME FROM:Your Moamalat account manager will provide:
  • Merchant ID (MID)
  • Terminal ID (TID)
  • Secret Key (HEX format)

Why Choose This App?

• Uses Odoo's official payment flow (no hacks)
• 100% compliant with Moamalat documentation
• No custom controller maintenance required
• Future-proof and upgrade-safe
• Supports backend + frontend + portal payments
• Very lightweight and optimized