Odoo - Quickei Developer Docs

Accept Quickei QR payments at your Odoo POS and auto-reconcile invoices. The Quickei module integrates with Odoo’s Point of Sale and Accounting modules.

Requirements

Requirement	Version
Odoo	18.0 (Community or Enterprise)
Modules	`account`, `point_of_sale`
Quickei	Merchant account with API keys

Installation

Download the module

Download the quickei_pos module from your Merchant Dashboard under Integrations > Odoo.

Install in Odoo

Copy the quickei_pos folder to your Odoo addons directory:

cp -r quickei_pos /opt/odoo/addons/

Then restart Odoo and activate Developer Mode. Go to Apps > Update Apps List, search for “Quickei” and install.

Configure API credentials

Navigate to Settings > Quickei POS and enter:

Client ID — Your merchant API client ID
Client Secret — Your merchant API secret
API Base URL — https://quickei.io/merchant-api/pos/v1
Webhook Secret — Auto-generated, used for signature verification

Click Test Connection to verify.

Configure the webhook

Set your webhook URL in the Quickei Merchant Dashboard:

https://your-odoo.com/quickei/webhook

Features

POS QR Payments

At the Odoo Point of Sale, select Quickei QR as the payment method. A dynamic QR code is generated for the customer to scan with the Quickei app. Payment confirmation appears in real-time.

Invoice Auto-Reconciliation

When you validate (post) an invoice, the module automatically:

Creates a Quickei payment order linked to the invoice
Generates a payment link sent to the customer
On payment, receives a webhook and creates a Payment Entry in Odoo
Reconciles the invoice — no manual journal entries needed

Webhook Events

Quickei Event	Odoo Action
`pos.order.paid`	Create Payment Entry, reconcile invoice
`pos.order.expired`	Mark payment as expired
`pos.order.cancelled`	Mark payment as cancelled
`pos.order.refunded`	Create reverse Payment Entry

Webhook Signature Verification

Every webhook includes an X-Quickei-Signature header. The module verifies it automatically:

import hmac, hashlib

def verify_signature(payload_bytes, signature, secret):
    expected = hmac.new(
        secret.encode(),
        payload_bytes,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)

API Client

The module includes a built-in API client with these methods:

Method	Description
`create_order()`	Create a POS order with QR code
`get_order()`	Check order status
`cancel_order()`	Cancel a pending order
`list_orders()`	List all orders
`test_connection()`	Verify API credentials

Create Order Example

order = self.env['quickei.api'].create_order(
    amount=150.00,
    currency='EUR',
    reference='INV/2026/0042',
    description='Invoice payment',
    payment_method='both',
    callback_url='https://your-odoo.com/quickei/webhook',
    expires_in=600,
    idempotency_key='INV-2026-0042',
)
# order['data']['qr_data'] → QR code content
# order['data']['payment_url'] → Payment page URL

Troubleshooting

Test Connection fails

Verify your Client ID and Client Secret are correct. Ensure your Odoo server can reach https://quickei.io (check firewall/proxy settings).

Webhooks not received

Ensure https://your-odoo.com/quickei/webhook is publicly accessible. Check Odoo logs for signature verification failures. Verify the webhook secret matches in both Quickei and Odoo settings.

Payment Entry not created

Check that the invoice reference in the webhook payload matches an existing invoice in Odoo. Verify the account module is installed and the default payment journal is configured.

The Odoo module currently supports Odoo 18. For older versions, contact support for compatibility assistance.

​Requirements

​Installation

​Features

​POS QR Payments

​Invoice Auto-Reconciliation

​Webhook Events

​Webhook Signature Verification

​API Client

​Create Order Example

​Troubleshooting

Requirements

Installation

Features

POS QR Payments

Invoice Auto-Reconciliation

Webhook Events

Webhook Signature Verification

API Client

Create Order Example

Troubleshooting