SolutionsSystem status
Documentation
Create accountContact
Start typing to search…

Odoo (draft2)

Prerequisites

  • MultiSafepay account
  • Odoo 18.0
  • Python 3.9+ (tested on 3.12)
  • Administrator privileges on your Odoo instance

Installation

Before installing the module, make sure all its Python dependencies are installed in the same Python environment used by your Odoo instance:

pip install multisafepay

The module can be installed in two ways:

Manual Installation from the Odoo Interface

  1. Sign in to your Odoo backend as Administrator.

  2. Go to Apps > Update Apps List.

  3. Go to Apps > Import module.

  4. Select the ZIP file of the module "payment_multisafepay_official".

  5. After uploading, search for MultiSafepay in the Apps list.

  6. Click Install.

  7. Go to Apps > MultiSafepay and click Activate.

Server Installation

This installation method is intended for administrators who have access to the server where Odoo is running. Unlike the manual upload, the module must be placed on the server inside an existing custom addons directory or in a new directory that you add to Odoo’s configuration file.

  1. Edit your odoo.conf file to find (or define a new one) 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_official .
  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 the MultiSafepay in the Apps list.
  6. Click Install.
  7. Go to Apps > MultiSafepay and click Activate.

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.

User guide

Orders

Your customers can place orders through the checkout page, and administrators can also create invoices directly from the Odoo backend.

Checkout page
  1. After selecting an item, click View cart > Checkout.
  2. Enter an existing address or provide a new one. You can configure delivery and billing addresses individually.
  3. Click Confirm.
  4. At the checkout page, select the payment method and click Pay now.
  5. Provide any required information (e.g. bank account number), and confirm payment.
  6. When the transaction is completed, Odoo will receive an Order Confirmed webhook notification and will confirm the order.
  7. You can find your orders confirmed under Website > eCommerce > Orders.
Create an invoice
  1. Sign in to your Odoo backend.
  2. Go to Invoicing > Customer > Invoices
  3. Click New.
  4. Fill the required fields:
  • Select an existing customer or create a new one under Customer > Search More > New.
  • Enter an existing Delivery Address or create a new one.
  • Select the item under Invoice Lines.
  1. Click Send to email the invoice to the customer.
  • The customer can open the invoice from the email and click the Pay Now button if the invoice is unpaid.
  • Alternatively, as an administrator you can generate a Payment Link from the invoice, copy it, and send it manually to the customer.

Refunds

In Odoo, you can process full and partial refunds. Orders that have been shipped cannot be refunded unless returned. To process a refund for an order:

  1. Sign in to your Odoo backend.
  2. Go to Website > eCommerce > Orders.
  3. Click the relevant order you want to refund.
  4. On the order page, go to Invoices > Payments.
  5. Click Refund. Enter the maximum allowed amount for a full refund or modify it to process a partial refund.
  6. Click Refund.

Payment methods

By default, any payment method you activate in your MultiSafepay account will be available for your backend. Newly activated payment methods must be enabled manually in your backend settings.
To configure your payment methods:

  1. Sign in to your Odoo backend.
  2. Go to Invoicing > Configuration > Payment Providers.
  3. To enable or disable payment methods individually, click Enable Payment Methods. Here, you can inspect each payment method, their minimum and maximum amounts and supported currencies.

Updates

Before updating:

  • Create a backup of your database, especially before an update.
  • Always download the latest Odoo version from our official MultiSafepay repository.
  • Replace old module files with the updated files.
How to update your plugin
  1. Update the required Python dependencies by entering the following command
cd payment_multisafepay_official/
pip install -r requirements.txt --upgrade
  1. Restart Odoo
  2. Upgrade your Odoo module by going to Apps > MultiSafepay Official > Upgrade.
    You can also upgrade the module via the following command line:
odoo-bin -u payment_multisafepay_official -d your_database_name

💬

Support

Contact MultiSafepay:

Updated about 12 hours ago