Webkul Store
Odoo Website AlinmaPay Payment Acquirer

Description

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.

No Reviews
No Showcase.
Product Version
1.0.0
Supported Browsers
Firefox 5+Google Chrome 14+Internet Explorer 7Internet Explorer 8Opera 11Safari 5
Category
Tags
Released
6 days ago
Last Updated
Today
Supported Version
19.x