Odoo Website AlinmaPay Payment Acquirer adds AlinmaPay to the Odoo website checkout. Shoppers pay on the AlinmaPay hosted page, and Odoo records the result.
- Add AlinmaPay as a payment provider on the Odoo website checkout.
- Send shoppers to the secure AlinmaPay hosted payment page to pay.
- Accept the card methods enabled on your AlinmaPay terminal.
- Keep the AlinmaPay transaction ID as the provider reference.
- Charge the card at checkout, or authorize it and capture later.
- Capture part of an authorized amount and void the rest.
- Refund a confirmed payment in full or in part from Odoo.
- Run trial orders in the AlinmaPay sandbox before going live.
- Description
- Reviews
- FAQ
- Customers ()
- Specifications
- Cloud Hosting
- Changelog
Odoo Website AlinmaPay Payment Acquirer is an Odoo module that connects AlinmaPay, a Saudi payment gateway, to the website checkout. Shoppers pay on the AlinmaPay hosted payment page.
A shopper picks AlinmaPay on the payment step and lands on the gateway page. Card details stay with AlinmaPay, and the Odoo database never holds them.
Each attempt updates the Odoo payment transaction. The AlinmaPay transaction ID lands in Provider Reference, and the sales order follows the same status.
Admins add the Terminal ID, Terminal Password and Merchant Key under Invoicing > Configuration > Payment Providers. Test Mode points the same credentials at the AlinmaPay sandbox.
The module runs on Odoo Community and Enterprise, on-premise or on Odoo.sh. It builds on the Payment app, works with Odoo eCommerce, and needs an AlinmaPay merchant account.
Additionally, merchants who sell outside Saudi Arabia can look at the Odoo Website PayU Payment Acquirer for the same checkout step.

Highlighted Features of Odoo Website AlinmaPay Payment Acquirer
AlinmaPay Checkout Option
Shoppers pick AlinmaPay on the Odoo payment step and go to the gateway page with the order total already set.
Terminal Payment Methods
Customers pay with the methods live on your AlinmaPay terminal, such as mada, Visa, MasterCard and Apple Pay.
Automatic or Manual Capture
Take the money at checkout, or authorize the card first and capture it on the day the goods ship.
Partial Capture and Void
Capture part of an authorized amount, then release what is left, from the payment transaction form.
Refunds From Odoo
Send a full or partial refund to AlinmaPay from a confirmed transaction, without opening the gateway portal.
Sandbox Test Mode
Test Mode sends the same credentials to the AlinmaPay sandbox, so a trial order never touches a live card.
Why Do We Need Odoo Website AlinmaPay Payment Acquirer?
Saudi merchants collect card money through a local gateway such as AlinmaPay. Odoo ships with a list of payment providers, and AlinmaPay is not on it.
Shops then take the card payment outside Odoo and mark the website order as paid by hand. A missed charge or a wrong amount costs the team an hour it did not plan for.
This module puts the gateway in the checkout. AlinmaPay answers Odoo after every attempt, and the payment transaction moves to its new state on its own.
Manual capture shows how close the two sides sit. An authorized record carries Capture Transaction and Void Transaction, and the Capture dialog takes any amount up to the Authorized Amount.
Also, shops that let trusted buyers pay after delivery can read about Odoo Website PayLater.
Odoo Website AlinmaPay Payment Acquirer Use Cases
-
Saudi Online Store
A Riyadh retailer sells in SAR and takes mada and card money on the Odoo website, with no step outside the checkout.
-
Ship Then Charge
A seller authorizes the card at checkout and captures the money on the day the delivery order leaves the warehouse.
-
Part Shipment Billing
A wholesaler captures the value of the goods that ship today and voids the rest of the authorized amount.
-
Returns and Cancellations
Support staff refund a confirmed payment in full or in part, and each refund keeps a link to its source transaction.
Configure AlinmaPay Credentials in Odoo
The AlinmaPay provider record holds the terminal details. Admins fill them once, and every website order uses the same record.
- Open Invoicing > Configuration > Payment Providers and pick AlinmaPay.
- Enter the Terminal ID, Terminal Password and Merchant Key from AlinmaPay.
- Add the Merchant ID and a Custom API URL only when the account needs them.
- Set State to Test Mode for the sandbox, or Enabled for live money.
- Turn on manual capture when the charge should wait for the shipment.

Choose AlinmaPay at the Website Checkout
AlinmaPay sits with the other options on the Odoo website checkout. Shops tuning the cart step itself can look at Odoo Website Cart Settings.
Pay now hands the shopper to the gateway with the order total already filled in. Shops that also let buyers collect goods in person can add Odoo Website Store Pickup.
- The provider shows up once State is Enabled or Test Mode.
- Odoo passes the order reference, amount and currency to AlinmaPay.
- Billing name, email, street, city and country travel with the request.
- Shoppers come back to the Odoo payment status page after they pay.
- The customer portal shows the sales order with its payment message.

Pay on the AlinmaPay Hosted Payment Page
Card entry happens on the AlinmaPay hosted payment page, so no card number reaches Odoo.
Buyers choose Cards, type the card number, expiry, CVV and cardholder name, then confirm. Teams weighing a second gateway can compare the Odoo Website Wepay Payment Acquirer.
- The page lists the methods enabled on your AlinmaPay terminal.
- A terminal can carry mada, Visa, MasterCard and Apple Pay.
- Odoo signs each request with the Merchant Key before it leaves.
- AlinmaPay answers with an encrypted result that Odoo decrypts.
- The module keeps no saved cards, so every order opens the page.

Capture or Void an Authorized Payment
With manual capture the checkout only authorizes the card. A transaction waits at Authorized until somebody acts on it.
Capture Transaction and Void Transaction sit at the top of the transaction form.
- The Capture dialog shows Authorized Amount and Amount To Capture.
- Lower that figure to capture part of the authorized money.
- Tick Void Remaining Amount to release the balance at the same time.
- Void Transaction cancels the whole authorization at AlinmaPay.
- Every capture lands as a child transaction under the first record.

Refund a Confirmed AlinmaPay Payment
Money can go back to the buyer in full or in part. Odoo sends the refund to AlinmaPay against the original transaction ID.
- Open the customer payment that the confirmed transaction created.
- Refund opens a dialog with Payment Amount and Refund Amount.
- Maximum Refund Allowed caps what is still open to send back.
- Odoo keeps the refund as a negative amount, such as -10.00 SR.
- Source Transaction points the refund at the payment it reverses.
- Each refund carries its own AlinmaPay provider reference.

Track Every AlinmaPay Payment Transaction in Odoo
Each attempt is a payment transaction in Draft, Pending, Authorized, Confirmed, Canceled or Error. Managers read the state without opening the AlinmaPay portal.
Groups that sell from several storefronts in one database can add Odoo Multi Website on top.
- Reference, Customer, Amount and Payment Method sit on the form.
- Provider Reference holds the AlinmaPay transaction ID.
- Created on and Last State Change Date show the timing of a charge.
- Child transactions list every capture and refund with its status.
- A gateway error message lands on the transaction for the admin.

Support
For any query or issue, please create a support ticket here CREATE A TICKET HERE
You may also check our top-quality Odoo Apps.
Specifications
Frequently Asked Questions
Specification
Detailed technical features and requirements to help you understand the module’s capabilities and ensure smooth integration with your system.
Cloud Hosting
Detailed technical features and requirements to help you understand the module’s capabilities and ensure smooth integration with your system.
Move to Cloud Today
We’re partnered with top-tier, trusted providers!
Default Configuration Details of Server
RAM 1 Core
Processor 30 GB
Hard Disk
Database
Want to know more how exactly we are going to power up your eCommerce Website with Cloud to fasten up your store
* Server Configuration may vary as per application requirements.