MultiSafepay Official Modules for Odoo

About MultiSafepay

MultiSafepay is a Dutch payment services provider, which takes care of contracts, processing transactions, and collecting payment for a range of local and international payment methods. Start selling online today and manage all your transactions in one place!

Prerequisites

Before installing the MultiSafepay module suite, ensure you have:

• Odoo 19.0 or compatible version
• Active MultiSafepay account. Consider a test account first. Sign up here if you don't have one.
• API Credentials from your MultiSafepay Control Panel
• Python 3.9+
• Administrative access to your Odoo installation
• Before installing, make sure to install the module’s Python dependencies on the same environment where Odoo runs:

  pip install -r requirements.txt
  

Modules

This repository no longer ships a single payment_multisafepay_official module. The previous functionality has been split into two Odoo addons:

• payment_multisafepay: core MultiSafepay payment provider integration.
• payment_multisafepay_enhanced: optional enhanced business logic on top of the core addon.

Installation

The modules can be installed in two ways:

Installation on a Self-Hosted or Docker Odoo Instance

This method applies to administrators with direct access to the Odoo server. In this case, the module must be deployed directly on the server. You can use an existing custom addons directory, or create a new one.

1. Edit the configuration file (odoo.conf). Add (or update) the addons_path entry to include the directory where the module is located:

   # In your odoo.conf file
   addons_path = /path/to/odoo/addons,/path/to/custom_addons
   

2. Copy the module into the custom_addons directory:

   cd /path/to/custom_addons
   cp -r /path/to/payment_multisafepay .
   # Optional (adds extra business logic/features)
   cp -r /path/to/payment_multisafepay_enhanced .
   

3. Restart your Odoo server:
   • Docker: docker-compose restart odoo
   • Systemd: sudo systemctl restart odoo
4. Sign in to your Odoo backend as Administrator and go to Apps > Update Apps List.
5. Search for MultiSafepay in the Apps list.
6. Click Install.
7. (Optional) Install MultiSafepay Enhanced if you need the additional business logic.
8. Go to Apps > MultiSafepay and click Activate.
9. Go to Invoicing > Payment Providers to activate and configure MultiSafepay.

Installation on Odoo.sh

1. In your Odoo.sh project, open the Git repository connected to your instance.
2. Clone the repository locally:

git clone <your-odoo-sh-repository-url>
cd <your-odoo-sh-project>

3. Add the official MultiSafepay Odoo connector as a Git submodule inside your addons folder:

git submodule add https://github.com/MultiSafepay/odoo.git <your-addons-directory>/multisafepay

Ensure your addons_path includes <your-addons-directory>/multisafepay (Odoo only scans direct children of each addons_path entry). 4. Commit and push your changes: git add . git commit -m "Add MultiSafepay module" git push origin main 5. Odoo.sh will automatically build and deploy your changes. 6. Sign in to your Odoo backend as Administrator and go to Apps > Update Apps List. 7. Go to Apps > MultiSafepay and click Activate. 8. Go to Invoicing > Payment Providers to activate and configure MultiSafepay.

Configuration

1. Sign in to your Odoo backend.
2. Go to Invoicing > Configuration > Payment Providers.
3. Click MultiSafepay.
4. Select a State (Test Mode for test) and enter your corresponding test API Key.
5. Save your changes.
6. To get payment methods from your MultiSafepay account, go to Configuration and click "Pull Payment Methods" to fetch and activate all payment methods available in your account.
7. Test the integration: Submit a test transaction to ensure everything is functioning correctly.
8. Switch to Live Mode changing State to Enabled and enter your corresponding live API Key.
9. Verify that your payment method settings remain in place after switching to live mode.
10. Set the payment provider as Published.

Payment Methods Supported

The MultiSafepay integration supports all major payment methods available through MultiSafepay:

• Credit & Debit Cards: Visa, Mastercard, American Express, Maestro
• Digital Wallets: PayPal, Apple Pay, Google Pay
• Bank Transfers: SEPA Direct Debit, Bancontact, iDEAL, Sofort
• Buy Now Pay Later: Klarna, in3, Pay After Delivery
• Local Methods: And many more regional payment solutions

Updates

1. Backup Your Database (always recommended before updates)
2. Download Latest Version from official MultiSafepay repository
3. Replace Module Files with new version
4. Update Dependencies:

   pip install -r requirements.txt --upgrade
   

5. Restart Odoo and Upgrade Modules: Navigate to Apps and upgrade the installed addons, or via command line:

   odoo-bin -u payment_multisafepay -d your_database_name
   # Optional (only if installed)
   odoo-bin -u payment_multisafepay_enhanced -d your_database_name
   

Support

• Create an issue on this repository.
• Email integration@multisafepay.com

Contributors

If you see an opportunity to make an improvement, we invite you to create a pull request, create an issue, or email integration@multisafepay.com

As a thank you for your contribution, we'll send you a MultiSafepay t-shirt, making you part of the team!

Want to be part of the team?

Are you a developer interested in working at MultiSafepay? Check out our job openings and feel free to get in touch!

License

This project is licensed under the terms specified in the LICENSE file in the root directory of this repository.