TopSaver POS Integration
TopSaver loyalty integrated into Odoo Point of Sale via iframe and JWT
Connect your Odoo POS with the TopSaver loyalty platform. Cashiers apply promotions and discounts from a secure iframe; the amount is automatically reflected as a negative line on the receipt.
Quick start
Get TopSaver running in your Point of Sale in four steps.
1. Configure your API Key
Go to Settings â Point of Sale â TopSaver Integration, enter your TopSaver API Key and save. Optionally set the TopSaver POS URL and a custom discount product.
2. Open the POS and start an order
Open a POS session, add products to the ticket, then click TopSaver. The module sends the sale amount securely to TopSaver.
3. Apply loyalty in TopSaver
Complete the promotion or cashback flow in the TopSaver iframe inside Odoo. The cashier never leaves the Point of Sale screen.
4. Discount applied automatically
The discount is added to the order as a negative line (TopSaver Discount). Continue checkout as usual.
After installing or updating the module, close and reopen the POS session.
Loyalty flow in the POS
Click TopSaver with an open order. The module generates a JWT token with the sale amount and opens the TopSaver POS in a native Odoo modal.
- Secure communication with JWT (HS256)
- Origin validation on postMessage
- Without leaving the Point of Sale
Marketing promotions summarized in the receipt
After completing the process with TopSaver, the system adds a summary line to the receipt detailing the marketing promotion or discount applied. The cashier can instantly see the benefit granted, and the customer has full transparency about the received promotion.
- Clear visualization of the promotion applied on the POS receipt
- Highlighted breakdown for discounts or cashback
- Descriptive line name for each promotion (e.g.,"TopSaver Promo")
Automatic discount on the receipt
After completing the flow in TopSaver, the discount is decoded and added to the order as a negative line with the configured discount product.
- Dedicated discount product (hidden from catalog)
- Gross amount without taxes
- Line name: "TopSaver Discount"
Simple configuration
Configure the integration from Settings â Point of Sale â TopSaver Integration:
- TopSaver API Key
- TopSaver POS URL (production or test environment)
- Discount product (optional)
Requirements
- Odoo 19.0 with Point of Sale module
- No external Python dependencies
- Active account on TopSaver
- On-premise or Odoo.sh installation
- Not compatible with standard Odoo Online (SaaS)
Support
Need help with the integration or your TopSaver account?
Contact us at info@topsaver.app
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Point of Sale (point_of_sale)
• Discuss (mail) • Inventory (stock) • Invoicing (account) |
| Lines of code | 867 |
| Technical Name |
pos_topsaver |
| License | LGPL-3 |
| Website | https://topsaver.app |
Please log in to comment on this module