What you can do

• Accept Card Payments: Enable “Pay with card (LibraPay)” as a payment method during the Odoo eCommerce checkout.
• Portal Invoice Payments: Allow customers to pay their open invoices directly from the Odoo customer portal using their credit or debit cards.
• Automated Payment Status: Automatically update the status of Sales Orders and Invoices in Odoo based on the real-time feedback from Libra Internet Bank.
• Asynchronous Notifications (IPN): Use Instant Payment Notifications to ensure that payments are recorded even if the customer closes the browser before redirection.

How it works

LibraPay uses a secure redirect flow:

1. When a customer selects LibraPay at checkout, they are redirected to the secure LibraPay hosted payment page.
2. The customer enters their card details on the bank’s secure infrastructure.
3. After processing, LibraPay redirects the customer back to Odoo.
4. Odoo receives the transaction result (success, failure, or cancel) via both a synchronous return and an asynchronous IPN call, updating the records accordingly.

Business benefits

• Trust and Security: Leverage the reputation of a well-known Romanian bank (Libra Internet Bank) to build customer trust.
• Optimized for Romania: Specifically designed for merchants operating in Romania, supporting local card processing and currency.
• Reduced Manual Work: Automated synchronization of payment statuses reduces the need for manual reconciliation and speeds up order fulfillment.
• Improved Cash Flow: Instant card authorization ensures that funds are captured quickly, reducing the risk of unpaid orders.

Typical workflow

1. A customer places an order on your Odoo website or accesses an invoice in the portal.
2. They select LibraPay and are redirected to the bank’s secure payment page.
3. Upon successful payment, LibraPay notifies Odoo.
4. Odoo automatically marks the Sales Order as “Paid” (or “Authorized”) and creates the corresponding payment records.
5. Your team can immediately proceed with shipping or service delivery.

Features

• Secure Redirect Flow: Customer card data never touches your Odoo server, ensuring PCI compliance.
• IPN Support: Reliable payment confirmation via asynchronous backend-to-backend notifications.
• Test & Live Modes: Support for both testing (sandbox) and production environments with separate endpoints.
• Integration: Works seamlessly with Odoo’s standard payment and website_sale modules.
• Customizable Messages: Ability to configure custom messages for different payment outcomes (Done, Cancel, Pending).

Requirements

• LibraPay Merchant Account: You must have an active merchant agreement with Libra Internet Bank.
• Python Dependencies:
  • phpserialize (installed automatically via Odoo’s external dependencies).

Configuration

1. Navigate to Accounting (or Invoicing) > Configuration > Payment Providers.
2. Locate and open LibraPay.
3. Set the State to Test Mode (for development) or Enabled (for production).
4. Fill in the credentials provided by Libra Internet Bank:
   • Merchant name
   • Merchant URL
   • Merchant ID
   • Merchant Email
   • Terminal ID
   • User and Password
   • Key (Security Key)
5. Configure the Payment Journal where transactions should be recorded.
6. Webhook (IPN) Setup: In your LibraPay merchant portal, configure the IPN URL to: https://your-domain.com/payment/libra_pay/ipn.

Support

Maintainer: Terrabit (Deltatech) — https://www.terrabit.ro — odoo@terrabit.ro

License: OPL-1

Table of contents

Authors

• Terrabit
• Dorin Hongu

Maintainers

Current maintainer:

This module is part of the terrabit-ro/bitshop project on GitHub.

You are welcome to contribute.