MultiSafepay plugin for Odoo

This technical manual is for installing and configuring our free plugin for integrating MultiSafepay payment solutions into your Odoo webshop. Our plugin receives regular updates from Odoo and MultiSafepay.


Contact us:

  • Telephone: +31 (0)20 8500 500
  • Email: [email protected]
  • GitHub: Create a technical issue



  • MultiSafepay account – See Getting started.
  • Odoo 13.0
  • Tested on Python 3.6


We recommend first installing the plugin in a test environment following, the recommended Odoo installation procedure. Make sure you have made a backup.
  1. Download the ZIP archive with module.
  2. Unpack the content of the .ZIP file.
  3. In your Odoo server (/mnt/extra-addons/), under Custom apps, add the payment_multisafepay_official folder.
  4. Install the required Python dependencies:
    pip3 install -r requirements.txt
    Alternatively, you can install them manually:
    pip3 install multisafepay==0.2.0
    For more information about dependencies, see Python - MultiSafepay.
  5. Restart your Odoo server.
  6. In your Odoo backend, activate developer mode.
  7. Go to the Apps menu > Update apps list.
  8. Search for and open the MultiSafepay payments module payment_multisafepay_official.
  9. Click Install.


  1. Sign in to your Odoo backend.
  2. Go to the Invoicing or Website menu > Configuration > Payment acquirers.
  3. Select MultiSafepay payment acquirer.
  4. Go to Edit mode.
  5. By default, acquirer state is disabled. To change the state, click Enabled or Test.
  6. Enter Live and/or Test API key.
  7. On the Configuration tab, set Journal.
  8. Click Save.
  9. To get payment methods from your MultiSafepay account, go the Configuration tab, click Pull payment methods.
    Make sure the relevant payment methods are activated for your account.
  10. Configure for each payment method separately:
    - Name
    - State
    - Country: Disabled for some payment methods
    - Customer group
    - Order amount: Disabled for some payment methods
    - Supported currency: Some payment methods process transactions only in EUR. Orders not created in EUR are converted to the required currency, using Odoo platform currency rate. This can only be configured by a system administrator.

User guide

Configuring generic gateways

The Odoo plugin offers a generic gateway that supports all payment methods.

You can:

  • Filter the generic gateway by country, and minimum and maximum amount
  • Refund completed orders only

To configure the generic gateway:

  1. Sign in to your backend.
  2. Go to Invoicing > Payment method > Other payment acquirer > MultiSafepay.
  3. In the Title field, set the relevant payment method gateway IDs.
  4. Set the gateway logo and name.
Updating the plugin

To update the plugin:

  1. Sign in to your Odoo backend.
  2. Go to the Apps menu.
  3. Search for and open the MultiSafepay payments module.
  4. Click Upgrade.


Propose a change on GitHubexternal-link-icon or
send an email to [email protected]

Other languages

For an explanation in another language, contact your account manager.