POS Ecart Pay — Integration Guide

What you get

• An Ecart Pay payment button in the Odoo POS (Sales and Restaurant).
• The charge is sent to your physical terminal (card reader); the cashier sees on screen when
  the payment is approved or declined.
• No extra keys: it reuses the configuration of the Ecart Pay module you already have.

Contents

1. Before you start
2. Install the module
3. Configure the POS payment method
4. Charge on the POS
5. Follow the payment on the terminal
6. Payment completed
7. FAQ
8. Support

1. Before you start

You need:

• Odoo 19 with the Point of Sale module installed.
• The Payment Provider: Ecart Pay module already installed and configured with your
  credentials (this terminal reuses that configuration). See that module's guide if you haven't
  done it yet.
• At least one Ecart Pay physical terminal registered in your account.

2. Install the module

1. Install Payment Provider: Ecart Pay first (if you don't have it).
2. In Odoo, go to Apps → Update Apps List, search for POS Ecart Pay and install it.

3. Configure the POS payment method

1. Go to Point of Sale → Configuration → Payment Methods.
2. Create or edit a payment method and, under Use a Payment Terminal, choose Ecart Pay.
3. Click Sync terminals. Odoo will pull the available terminals from your Ecart Pay account.
4. Select the Ecart Pay Terminal (branch + sales register) that should charge with this method.
5. Add this payment method to your Point of Sale
   (Configuration → Point of Sale → Payments).

Image placeholder: POS payment method with Ecart Pay and the selected terminal

4. Charge on the POS

1. Open a POS session and build the ticket as usual.
2. On the payment screen, select Ecart Pay and enter the amount.
3. The charge is sent to the physical terminal.

Image placeholder: POS payment screen selecting Ecart Pay

5. Follow the payment on the terminal

While the customer presents the card (insert, tap or swipe), the POS shows the Waiting for
terminal status. The system checks the status automatically until the payment completes (up to
3 minutes, enough time for PIN entry, retries and bank authorization).

Image placeholder: POS in "Waiting for terminal" status

6. Payment completed

• If the payment is approved, the payment line turns to Done and you can close the sale and
  print the receipt.
• If it's declined or cancelled, you'll see a message and can retry or choose another method.

Image placeholder: POS after a successful payment (closed sale / receipt)

7. FAQ

"Ecart Pay" doesn't appear when configuring the payment terminal.
Make sure the POS Ecart Pay module is installed and the base Payment Provider: Ecart Pay
module is configured.

I clicked "Sync terminals" and none appear.
Check that you have physical terminals registered in your Ecart Pay account and that the provider
credentials (test/production mode) are correct.

The charge stays on "Waiting for terminal".
Check that the physical terminal is powered on and connected. If the wait times out, check the
status directly on the terminal before retrying, to avoid charging twice.

Do I need other keys besides the payment module ones?
No. This module reuses the credentials and token of the Ecart Pay provider you already
configured.

8. Support

• Technical documentation: docs.ecartpay.com
• Website: ecartpay.com
• Support email: [email protected]

_{Ecart Pay is a registered trademark of Envia. Odoo is a trademark of Odoo S.A. This project is
not officially affiliated with Odoo S.A.}