Technical manual for MultiSafepay's free plugin.



✅   Tip! We recommend first installing the plugin in a test environment, following the Odoo installation procedure. Always make 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. To change the acquirer state, click Enabled or Test. (Default: Disabled)

  6. Enter Live and/or Test API key.

  7. On the Configuration tab, set Journal, and then click Save.

  8. 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.

  9. Configure each payment method separately:

    Payment method settings
    • 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

Generic gateways

The plugin supports generic gateways, which allows you to add a payment method manually. This is particularly useful for integrating gift cards specific to your business.

Supported since release: 1.1.0, July 2nd 2021.

How to configure generic gateways
  1. Sign in to your Odoo 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.


How to create orders
  1. Select the payment method on the checkout page, and then click Pay now.
  2. Provide any required information (e.g. bank account number), and confirm payment.
  3. When the transaction is completed, you receive a Order { order ID } Confirmed webhook notification .
How to ship orders
  1. Go to the Website menu> Orders, and then select the relevant order.
  2. To mark the order as Shipped, go to Delivery and Validate transfer.
    The transaction status changes to Shipped.
  3. Under Order details, you can create an invoice. Its status is Paid right away because the order was prepaid.
  4. If you want to update the invoice ID of the transaction with MultiSafepay, go to Configuration > Payment transactions, select the relevant transaction, and then click Update invoice ID.

Payment methods

Supported payment methods


How to refund orders

In your Odoo backend, you can only refund Completed orders.

  1. To create a refund invoice, go to Order invoices, and then click Add credit note.
  2. Enter a Refund reason and check the invoice lines you want to return, and then click Post.
  3. To create a refund request, click Refund with MultiSafepay.
  4. If the request is created successfully, the invoice status changes.
  5. When the status of the MultiSafepay refund transaction changes to Completed, the status of the refund invoice changes to Paid.
How to refund BNPL orders

For BNPL orders, the refund request must include a shopping_cart object where:

  • The item_quantity must not be more than quantity in the original order.
  • The item_price must be equal to the unit_price in the original order.

❗️ Note: You cannot refund BNPL orders if a gift card or promo code was used for the original order.


You can update in your backend.

How 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.



Contact MultiSafepay:

Top of page