This module integrates MONEI payment services with Odoo, providing a seamless way to track and manage your MONEI payments directly within Odoo.
- Payment Synchronization:
- Manual sync of payments from MONEI to Odoo
- Sync payments by date range
- Import historical payments
- Order Integration:
- Automatic linking with Odoo sale orders using order references
- View linked payments directly from sale orders
- Payment Management:
- View payment status and details
- Process refunds
- Capture authorized payments
- Cancel pending payments
- Dashboard Access: Direct links to MONEI Dashboard for each payment
- Go to your project on Odoo.sh
- Navigate to the "Repositories" tab
- Click "Add a Repository" and select "Add a Git Repository"
- Enter the repository URL:
https://github.com/MONEI/MONEI-Odoo
- Select the branch you want to deploy
- Go to the "Branches" tab and activate the branch where you want MONEI installed
- Wait for the deployment to complete (you can check status in "Builds")
- Once deployed, go to Apps and search for "MONEI"
- Click Install on the MONEI module
Note: If you don't see the module in Apps after deployment:
- Enable developer mode (Settings → General Settings → Developer Tools → Activate the developer mode)
- Go to Apps → Update Apps List (menu in the top bar)
- Search for "MONEI" again
- Download the module
- Place the
monei
folder in your Odoo addons directory:- Linux:
/opt/odoo/addons/
or/usr/lib/python3/dist-packages/odoo/addons/
- Windows:
C:\Program Files\Odoo\server\odoo\addons\
- Linux:
- Restart your Odoo server
- Update the apps list in Odoo:
- Enable developer mode
- Go to Apps > Update Apps List
- Search for "MONEI" and install the module
Before installing:
- Make sure you have a MONEI account
- Have your API key ready (test or production)
- Ensure you have admin rights in your Odoo instance
Use your test mode API Key. You can find them in MONEI Dashboard → Settings → API Access.
You can check the status of a test payment in your MONEI Dashboard → Payments (in test mode).
- Go to MONEI > Configuration or Settings > MONEI in Odoo
- Enter your MONEI API Key
- Save the configuration
The module will automatically sync your payments.
Make sure that you are using live (production) mode API Key.
Make sure that you have at least one active payment method.
-
Initial Sync
- After configuring your API key, use the Sync button to import payments
- Select a date range to import payments from that period
- The module will import all MONEI payments within the selected dates
-
Syncing Process
- Go to MONEI > Payments
- Click the "Sync Payments" button
- Select start and end dates for the sync
- The module will:
- Import new payments from the selected period
- Update existing payment information
- Show a summary of changes when complete
-
Order Matching
- Payments are automatically linked to sale orders using the order reference
- Each payment's order reference is matched to a sale order number
- View linked payments directly from the sale order form
Navigate to MONEI > Payments to see all your MONEI payments in one place.
Each payment supports various actions depending on its status:
- Create: Create a new payment
- Refund: Process full or partial refunds
- Capture: Capture authorized payments
- Cancel: Cancel pending payments
- Send payment link: Send payment link to the customer
- View Order: Direct access to linked sale order
The module automatically links payments with sale orders based on the order reference. You can also:
Common issues and solutions:
- Module not visible after installation: Update the apps list in developer mode
- Orders not linking: Ensure order references match between MONEI and Odoo
For support:
- Check the MONEI Documentation
- Contact MONEI Support
- Create an issue in this repository
This module is licensed under LGPL-3.
Developed by MONEI