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.

Test environment

We recommend first installing the plugin in a test environment following the recommended Odoo installation procedure. Make sure you have made a backup.


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


  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,Oo the Configuration tab, click Pull payment methods.
    Make sure you have activated the relevant payment methods in your MultiSafepay 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. The generic gateway can be found under Invoicing > Payment method > Other payment acquirer > MultiSafepay.

All of our payment methods are supported. You can set the gateway code using the title field. The gateway logo and gateway name can also be changed.

Similar to other gateways, it is possible to filter the generic gateway by:

  • Countries
  • Min amount
  • Max amount

Refunds are only possible with fully completed orders.

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.