Imagine you're running a retail shop. A customer grabs a few items, walks to the counter, and wants to pay with their phone. You tap a few buttons on Odoo POS. A QR code appears on your screen. They scan it, confirm, and the transaction completes in seconds. No extra card reader. No separate app. No waiting.
That workflow is now possible inside Odoo POS, thanks to a new module from Webkul that connects Wallee's QR-based payment gateway directly to the point-of-sale system. The integration handles secure card entry, real-time payment status updates, and backend transaction tracking. Setup works with Odoo versions 18 and 19, and it requires the POS Payment Base module as a foundation before anything else.
Quick take
- Wallee QR payments integrate directly into Odoo POS checkout workflow
- Requires POS Payment Base module as a mandatory dependency
- Real-time payment status updates appear within the POS system
- Compatible with Odoo V18 and V19
- Current module version: 1.0.0
What Wallee Brings to Odoo POS
The core value here is simplicity. Wallee's gateway lets customers pay by scanning a QR code with their phone. The card entry happens on Wallee's hosted payment page, not on your POS hardware. That means you don't need a dedicated card terminal for every checkout lane.
The integration supports several features that matter on the shop floor. QR-based payments at checkout handle fast, contactless transactions. The secure hosted payment page moves sensitive card data away from your POS system entirely. Real-time status updates keep the register in sync with what the payment gateway is doing. Transaction records live in Odoo's backend with status tracking so reconciliation stays clean.
Step-by-Step Setup
First, grab the module from Webkul's store. After purchase, you'll receive a download link. Extract the zip file on your system and look for the folder named "pos_wallee_payment_acquirer". Copy that folder into your Odoo add-ons path.
Next, open Odoo and enable developer mode. Head to the Apps section and click "Update Apps List" to refresh the module catalog. Search for "pos_wallee_payment_acquirer" without any filters. You should see the module appear in the results. Click Install.
Once installed, the configuration steps are straightforward. Open the backend and locate the Wallee configuration settings. Enter your User ID, Authentication Key, and Area ID to connect the gateway. Then go to POS Payment Methods, create a new method, select Wallee as the payment acquirer, and enable it.
You're ready at the register. When a customer reaches checkout, choose Wallee as the payment method. Odoo generates a QR code on the cash register screen. The customer scans it with their device, sees the secure payment page, enters card details, and confirms. The payment status updates in real time within your POS, and the transaction record appears in the backend with appropriate status tracking.
Practical Example
Say you manage a mid-sized retail store running Odoo POS across three checkout lanes. During peak hours, card payments slow down the queue because each transaction requires the customer to hand over a physical card and wait for authorization to complete on a terminal.
With the Wallee integration, customers can pay directly from their phones by scanning the QR code displayed at checkout. You still get the same secure processing through Wallee's gateway, but the card reader stays free for customers who prefer it. The real-time status update means your staff knows immediately whether the payment succeeded. If it did, they can bag the items and move on. No stepping away to check a terminal. No guessing.
This approach matters if your customer base skews toward mobile payment users. It also helps during busy periods when having fewer pieces of hardware at each station reduces clutter and potential points of failure.
Why This Matters
QR payments are becoming standard in retail environments where speed and contactless options matter. The hosted payment page shifts the card-entry experience to the customer's device, which reduces the hardware burden on your POS setup. For Odoo users specifically, this fills a gap — native QR payment support within the POS interface, without needing separate middleware or third-party terminals.
The dependency on POS Payment Base is worth flagging. If your Odoo setup doesn't already have it, you're adding an extra module to your installation pipeline. That has testing implications. For teams running older Odoo versions, the upgrade path to V18 or V19 may need to happen before this integration becomes viable.
Version 1.0.0 suggests early-stage software. Production deployments should include thorough testing, especially around payment reconciliation during your first billing cycles. Check Webkul's store for updates before committing to a live environment.
What to Watch Next
The module currently covers QR-based and card payments through Wallee's hosted page. Future updates could expand support for additional payment types or deeper Odoo inventory integration. Since Webkul maintains this module actively, watch their store for version releases.
For teams evaluating payment options within Odoo, this integration is worth a closer look if contactless, QR-based checkout fits your customer base and operational setup.
Key takeaways
- Wallee QR payments integrate directly into Odoo POS checkout, reducing hardware requirements
- POS Payment Base module is a mandatory dependency — plan for it in your installation timeline
- Real-time payment status and backend transaction tracking support reconciliation workflows
- Version 1.0.0 warrants extra QA before production deployment
- Support available through Webkul's ticket system for setup issues
Frequently asked questions
Which Odoo versions does the Wallee module support?
The module works with Odoo V18 and V19, according to the published reference.
What dependency is required before installing the Wallee module?
The POS Payment Base module must be installed first. Without it, the Wallee Payment Acquirer will not function.
How does the payment flow work at checkout?
Staff selects Wallee as the payment method in Odoo POS. A QR code appears on the register screen. The customer scans it, enters card details on Wallee's hosted page, and confirms. The POS receives a real-time status update and records the transaction in the backend.
Where are transaction records stored?
Each payment is logged in Odoo's backend with appropriate status tracking. You can review all transactions from the backend interface.
How can I get help if the module doesn't work during setup?
Webkul provides support through their ticket system. You can also reach out via their support email for questions not covered in the documentation.