NeroPay for Odoo • NeroPay Docs

NeroPay provides a secure and seamless payment experience fully integrated into Odoo. Whether you are using Odoo’s eCommerce, Website, or Invoicing apps, NeroPay allows your customers to pay directly through a modern, PCI-compliant gateway.

Available on Odoo App Store:

• Odoo 16 → NeroPay Payment

• Odoo 17 → NeroPay Payment

• Odoo 18 → NeroPay Payment

1. Overview

NeroPay is a secure and user-friendly payment gateway that connects directly to your Odoo environment. The integration uses NeroPay’s REST API and supports both Sandbox and Live modes for smooth testing and deployment.

2. Prerequisites

Odoo installation (version 16, 17 or 18).
Access to Invoicing → Configuration → Payment Providers.
Active merchant account on NeroPay.
Your Public API Key and Secret API Key.
HTTPS server for receiving IPN callbacks.

3. Installation

Upload the neropay_payment module to your Odoo add-ons folder or install it via the Apps menu.
Restart the Odoo server and update the Apps list.
Go to Invoicing → Configuration → Payment Providers.
Select or create provider NeroPay.
Enter your Public and Secret keys, choose Sandbox or Live, and enable it.

4. Payment Flow

The payment flow follows these steps:

User selects Pay with NeroPay at checkout.
Odoo creates a transaction and calls NeroPay’s API endpoint.

API Endpoints:

Live → https://eu.neropay.app/payment/initiate
Sandbox → https://eu.neropay.app/sandbox/payment/initiate

Example Request (POST):

{

"public_key": "YOUR_PUBLIC_KEY",

"identifier": "ORDER12345",

"currency": "GBP",

"amount": 120.00,

"details": "Sale of item #SKU1001",

"ipn_url": "https://yourdomain.com/payment/neropay/ipn",

"success_url": "https://yourdomain.com/payment/neropay/success",

"cancel_url": "https://yourdomain.com/payment/neropay/cancel",

"customer_name": "Jane Doe",

"customer_email": "jane@example.com",

"customer_phone": "01234 567890",

"customer_address": "123 High Street, Stockport, SK1 2AB",

"customer_shipping_method": "Delivery"

}

Example Response:

{

"success": "ok",

"message": "Payment Initiated. Redirect to url.",

"url": "https://eu.neropay.app/initiate/payment/checkout?payment_id=eJSAASDxdr..."

}

The customer is redirected to the URL above to complete payment securely on NeroPay’s hosted page. Once payment succeeds, NeroPay calls your ipn_url with a POST payload that includes status, identifier, signature, and data.

Example IPN Verification:

custom_key = data[\'amount\'] + identifier

my_signature = HMAC_SHA256(secret_key, custom_key).upper()

if status == "success" and signature == my_signature:

mark_transaction_as_paid()

5. Supported Currencies

British Pound (GBP)
Euro (EUR)
Indonesian Rupiah (IDR)

6. Testing in Sandbox

Sandbox endpoint: https://eu.neropay.app/sandbox/payment/initiate
Test mode e-mail: test_mode@mail.com
Verification code: 222666

7. Troubleshooting

IssueResolution
Payment button not visible	Ensure the provider is enabled and its journal currency matches the transaction currency.
No IPN received	Verify your server allows external POST requests from NeroPay.
Signature mismatch	Ensure your secret key is correct and the signature uses HMAC SHA-256.
Branch error on App Store	Confirm that the Git branch is named 16.0, 17.0, or 18.0 respectively.

Published for modules: Odoo 16 | Odoo 17 | Odoo 18