Install and Configure Odoo Plugin

After installing Odoo on your local machine or server, follow these steps for each operating system to configure the PayU custom add-on or plugin.

Prerequisites

Before you begin, ensure that:

• Odoo is installed and running on your local machine or server
• You have administrative access to the server (Linux/Windows)
• You have access to Odoo's configuration files
• You have a PayU merchant account (or can create one during setup)

📘

Notes:

• Developer mode must be enabled in Odoo to proceed with eCommerce and PayU module setup.
• This plugin has been developed and tested on Odoo 18, so it is recommended using version 18 or above for optimal compatibility and performance.

Install on Linux OS

To install the PayU custom add-on on Linux-based servers:

1. Create the directory structure for custom add-ons:

mkdir /opt/odoo/custom_addons

2. Clone the GitHub repository into the newly created folder:

cd /opt/odoo/custom_addons
git clone https://github.com/boxpay-tech/payu-connectors.git

After cloning, verify that the Payment_payu folder exists in the directory.

3. Modify the odoo.conf file to include the path to the custom addons folder:

sudo nano /etc/odoo/odoo.conf

4. Add the custom add-ons path to the addons_path configuration:

addons_path = /usr/lib/python3/dist-packages/odoo/addons,/opt/odoo/custom_addons

5. Restart the Odoo service to apply the changes:

sudo systemctl restart odoo

Install on Windows OS

Follow these steps to install the PayU Custom Addon on Windows systems:

1. Create a folder in the same drive where Odoo is installed (preferably in the C:/ drive):

C:/custom_addons

2. Open Odoo's installed folder and navigate to the server folder inside the installation directory.

3. Clone the PayU repository in your custom add-ons folder:

cd C:/custom_addons
git clone https://github.com/boxpay-tech/payu-connectors.git

4. Modify the odoo.conf file located in the server folder to include the path of the custom_addons folder under the addons_path:

addons_path = C:/Program Files/Odoo/server/addons,C:/custom_addons

5. Save the changes to the odoo.conf file.
6. Restart the Odoo service using Microsoft Windows Services:
   • Open Services from the Start menu.
   • Search and select the Odoo service.
   • Right-click and select Restart

Setup Odoo for eCommerce

After installing the PayU custom add-on, configure Odoo for eCommerce function:

Step 1: Enable Developer Mode

1. Open Odoo service hosted locally or on a remote server.

The Apps section is displayed on the Dashboard.

2. Select the Home menu and choose Settings in the upper left-corner.

The Settings page is displayed.

3. Clicl Activate the Developer Mode.

📘

Note: Developer Mode is required to access advanced configuration options.

Step 2: Install required modules

Return to the Apps section and activate the following modules:

• Website module
• eCommerce module

After activating these apps, your customers will be able access the Shop section similar to the following screenshot.

Step 3: Install PayU plugin

1. In the Apps section, search for "payu" and select it.

2. Click Activate on the PayU Payment Provider tile.

Step 4: Configure PayU as payment provider

To configure PayU as the payment provider:

3. From the Home page, navigate to Configuration > Payment Providers.

4. Find PayU and click Activate on the PayU tile to activate as the payment provider.

You will be redirected to PayU Configuration page on Odoo.

Step 5: Configure Key and Salt credentials

To configure credentials for payment transactions:

1. Select Enabled from the State field.
2. Perform any of the following procedures as per the environment you wish to configure and then click Save Credentials.

• For Test Transactions
• For Live Transaction

📘

Reference: You can obtain your merchant keys and Salt from your PayU Merchant Dashboard. For more information, refer to any of the following based on the Test or Production environment:

• Access Test Merchant Key and Salt
• Access Production Key and Salt

If you do not have a PayU account, sign up for a merchant account. For more information, refer to Register for a Merchant Account.

For Test Transactions

To configure the key/Salt for testing the transactions in Test or Sandbox environment:

1. Select state: "Test Mode"
2. Enter your Test merchant key.
3. Enter your Test merchant Salt.
4. Click Save to enable test payment transactions

For Live Transactions

To configure the key/Salt for collecting payments or live transactions or production environment:

1. Select state: "Enabled"
2. Enter your Production merchant key.
3. Enter your Production merchant Salt.
4. Click Save to enable live payment transactions.

Verification

To verify the installation:

1. Ensure the PayU module is displayed in your installed apps.
2. Check that PayU is available as a payment option in your eCommerce checkout.
3. Perform a test transaction to confirm functionality.