PayLater for Odoo

Buy now, pay later in Qatar: 4 interest-free instalments

Overview

PayLater is a Sharia-compliant Buy Now, Pay Later provider licensed by the Qatar Central Bank. This module adds PayLater to your Odoo eCommerce checkout, so shoppers can split a purchase into 4 interest-free instalments. You receive the order amount from PayLater, less your merchant service fee.

It also shows the instalment price on your shop and product pages, so shoppers see the option before they reach checkout.

Compatibility

ComponentSupported
OdooOdoo 18 only. The module does not install on Odoo 17, and Odoo 19 is not supported yet.
Required modulespayment and website_sale (the eCommerce app must be installed).
Store currencyQAR. Orders in any other currency are refused at checkout with "PayLater only accepts payments in QAR".
Order amountQAR 300 to QAR 25,000. PayLater is hidden at checkout outside this range.
HostingSelf-hosted Odoo or Odoo.sh. Odoo Online (SaaS) databases cannot install third-party modules.
Merchant accountA PayLater merchant account in Qatar. Get your credentials from your PayLater account dashboard.

What shoppers see

Product list page

PayLater widget on the Odoo product list page

Product detail page

PayLater widget on the Odoo product detail page

Instalment breakdown

PayLater instalment breakdown on the Odoo product detail page

Checkout

PayLater payment option on the Odoo checkout page

Features

Hosted checkout

Shoppers are redirected to PayLater's secure page to approve the payment, then return to your store's order confirmation.

Product page widgets

Show the instalment price on the shop and product pages. Off by default, switched on in Settings.

Reliable order status

Signed webhooks, a status check with PayLater on return, and a 15-minute check for payments still waiting for a result.

Refunds from Odoo

Issue full or partial refunds from the Odoo backend. They are recorded once PayLater accepts them.

Test and live modes

Test against the PayLater UAT environment before switching to Live.

Editable text

Change the widget headings, sub-headings and terms from the settings page, without code changes.

Install the module

  1. Download the module and extract the zip. Inside it you will find a payment_paylater_qa folder.
  2. Copy the payment_paylater_qa folder (not the outer folder from the zip) into one of your Odoo addons paths, for example /mnt/extra-addons/payment_paylater_qa. On Odoo.sh, commit it to your project repository instead, or use Deploy on Odoo.sh on this page.
  3. Restart the Odoo service.
  4. Turn on developer mode (Settings > Developer Tools > Activate the developer mode).
  5. Go to Apps, click Update Apps List, then remove the "Apps" filter and search for paylater.
  6. Click Activate (or Install) on PayLater Payment Provider.
PayLater Payment Provider in the Odoo Apps list
The installed PayLater Payment Provider module page in Odoo Apps

Upgrading

Replace the payment_paylater_qa folder in your addons path with the one from the new zip and restart Odoo. Then go to Apps, remove the "Apps" filter, search for paylater, open the menu on the PayLater card and click Upgrade. Your settings are kept.

Switching from version 3.x

From version 4.0 the module is called payment_paylater_qa (3.x and older used payment_paylater). Odoo treats it as a new module, so you switch over once:

  1. Open Website > Configuration > Payment Providers > PayLater and note your Client ID, Client Secret, Outlet ID and Webhook Secret. You can also find them in your PayLater merchant portal.
  2. Go to Apps, remove the "Apps" filter, search for paylater, open the menu on the old PayLater card and click Uninstall.
  3. Remove the old payment_paylater folder from your addons path, copy in the new payment_paylater_qa folder and restart Odoo.
  4. Install the module as described above, enter your credentials again and enable the provider.

Your widget settings (Settings > PayLater) are carried over automatically. Past PayLater payments stay in Odoo, linked to the old PayLater provider entry, which is left disabled. Do not install both versions at the same time.

Configuration

Go to Website > Configuration > Payment Providers (under eCommerce) and open PayLater.

Odoo Website Configuration Payment Provider screen

Fill in the PayLater fields on the Credentials tab:

FieldWhat to enter
EnvironmentUAT (Testing) with the test credentials, or Live (Production) with your live credentials.
Client IDYour OAuth client ID from PayLater.
Client SecretYour OAuth client secret from PayLater.
Outlet IDYour outlet ID from PayLater.
Webhook SecretProvided by PayLater after they register your webhook URL (see below).
Minimum Order AmountOrders below this amount do not see PayLater at checkout. Default 300, and it cannot be set below QAR 300.
PayLater payment provider settings with Client ID, Client Secret and Outlet ID fields
PayLater payment provider configuration details in Odoo
PayLater payment provider enabled in Odoo

Widget settings

Go to Settings > PayLater. The widgets are off by default: tick Product List Page (Shop) and Product Detail Page to show them, and set the minimum price, heading, sub-heading and terms text. Click Save Changes to finish.

PayLater widget settings under Odoo Settings

Testing

  1. Set the Environment to UAT (Testing) with your test credentials.
  2. Add a product to your cart and go to checkout.
  3. Select PayLater as the payment method. You are redirected to PayLater's secure page to complete the payment.
  4. Use a test shopper account from the PayLater test environment, and an order amount of QAR 300.

Test credentials and test shoppers are listed on the Test environment page of the PayLater developer docs: docs.paylaterapp.com

Data shared with PayLater

This module connects to the PayLater API (an external service) and only works with a PayLater merchant account. Nothing is sent until you enter your PayLater credentials and enable the provider, and a shopper chooses PayLater at checkout.

PayLater's privacy policy: paylaterapp.com/privacy-policy

Support

Contact the PayLater merchant integration team at support@paylaterapp.com

Full integration guide and release notes: docs.paylaterapp.com/odoo.html