POS Self Order QFPay

Integrate QFPay with Odoo POS self-service ordering system. Support WeChat Pay, Alipay, UnionPay and popular payment methods in Asia.

Self Order
QFPay
WeChat Pay
Alipay
UnionPay
Asian Payment

Overview

POS Self Order QFPay module integrates QFPay payment gateway with Odoo POS self-service ordering system.

Customers can place orders and pay via WeChat Pay, Alipay, UnionPay and popular e-wallets in China and Asia.


Key Features

Key points

  • • WeChat Pay payment - Scan QR code to pay via WeChat

  • • Alipay payment - Support Alipay and Alipay+

  • • UnionPay payment - Pay via UnionPay card and UnionPay QuickPass

  • • Multi-currency - Support CNY, HKD, USD, EUR and many currencies

  • • Dynamic QR code - Generate payment QR code for each order

  • • Instant authentication - Real-time payment confirmation via webhook

  • • Auto-refund - Process refunds directly through QFPay

  • • Transaction reports - Track all QFPay transactions in Odoo

  • • Offline mode - Save transactions when offline, sync later

  • • Multi-language - Support Chinese, English and Asian languages


Target Users

Key points

  • • Restaurants serving Chinese customers - Accept WeChat Pay and Alipay

  • • Retail stores in Asia - Diverse payments for international customers

  • • Airports and tourist areas - Serve Chinese tourists

  • • Shopping malls - Self-service kiosks with QFPay payment

  • • Duty-free shops - Convenient payment for Asian customers


How to Use

Steps

  • 1. Register QFPay merchant account at qfpay.com

  • 2. Receive API credentials (App Code, App Key, Merchant ID)

  • 3. Install POS Self Order QFPay module in Odoo

  • 4. Go to Settings → Point of Sale → select POS to configure

  • 5. In "Payment" tab, add new payment method

  • 6. Select "QFPay" as payment type

  • 7. Enter App Code, App Key, Merchant ID from QFPay

  • 8. Select environment (Production or Sandbox)

  • 9. Configure payment methods (WeChat, Alipay, UnionPay)

  • 10. Enable "Self Order" and select QFPay as payment method

  • 11. Configure webhook URL to receive payment notifications

  • 12. Test with trial transaction


Scenario 1: Restaurant with Chinese customers

Chinese customers order via kiosk, select WeChat Pay, scan QR code on screen and complete payment.

Configuration: Enable WeChat Pay and Alipay, display large QR code on screen, support Chinese language.


Scenario 2: Duty-free shop at airport

Asian tourists shop, scan products themselves, select Alipay or WeChat Pay and receive electronic receipt.

Configuration: Support multi-currency (CNY, HKD, USD), auto exchange rate conversion, print bilingual receipt.


Scenario 3: Coffee shop with app ordering

Customer orders coffee via app, pays with Alipay, comes to counter and receives drinks without showing anything.

Configuration: Integrate QFPay with mobile app, auto-confirm payment and notify beverage counter.


Scenario 4: Shopping mall with multi-language kiosk

International customers select language (Chinese, English, Vietnamese), order and pay via familiar method.

Configuration: Multi-language interface, display appropriate payment methods by customer region.


Scenario 5: Retail store with UnionPay QuickPass

Customer taps UnionPay card or phone supporting UnionPay QuickPass for quick payment.

Configuration: Enable UnionPay QuickPass, configure transaction limit without PIN, connect NFC device.


Important Terminology

Key points

  • • QFPay - Leading payment solutions provider for Asian market

  • • WeChat Pay - Most popular e-wallet in China

  • • Alipay - Alibaba e-wallet, widely used in Asia

  • • UnionPay - Largest card payment organization in China

  • • QR Code Payment - Payment by scanning QR code

  • • Merchant ID - Unique identifier of store in QFPay system

  • • App Code - Application code for API authentication

  • • Webhook - URL to receive payment notifications from QFPay

  • • Transaction ID - Unique transaction code

  • • Settlement - Process of transferring money from QFPay to merchant account


Tips for Effective Use

Key points

  • • Display payment method logos - Customers easily recognize WeChat Pay, Alipay

  • • Configure appropriate timeout - QR code expires after 5-10 minutes

  • • Check exchange rate daily - Ensure accurate currency conversion

  • • Enable webhook - Receive real-time payment notifications

  • • Monitor settlement reports - Reconcile money to account

  • • Prepare Chinese instructions - Help Chinese customers use easily

  • • Test with multiple wallets - Check WeChat Pay, Alipay, UnionPay all work

  • • Configure transaction limits - Align with merchant policy


System Requirements

Key points

  • • Activated QFPay merchant account

  • • API credentials from QFPay (App Code, App Key, Merchant ID)

  • • POS and POS Self Order modules installed in Odoo

  • • Stable internet connection for transaction authentication

  • • Public webhook URL to receive notifications from QFPay

  • • Browser supporting QR code display


Troubleshooting: QFPay not connecting

Key points

  • • Check API credentials are entered correctly

  • • Confirm merchant account is activated

  • • Check environment (Production/Sandbox) is selected correctly

  • • Check firewall not blocking connection to QFPay API

  • • View error logs in Odoo (Settings → Technical → Logging)

  • • Contact QFPay support to check account status


Troubleshooting: QR code not displaying

Key points

  • • Check internet connection is stable

  • • Confirm API request succeeded (view logs)

  • • Check browser supports QR code display

  • • Try refreshing page and regenerating QR code

  • • Check transaction amount is valid


Troubleshooting: Payment successful but order not updated

Key points

  • • Check webhook URL is configured correctly

  • • Confirm webhook URL is accessible from internet

  • • View webhook logs to identify error

  • • Check webhook signature verification

  • • Try manually syncing transaction from QFPay dashboard


Troubleshooting: WeChat Pay not working

Key points

  • • Check WeChat Pay is enabled in QFPay merchant account

  • • Confirm customer using official WeChat app

  • • Check QR code displays in correct WeChat format

  • • Try with different WeChat account

  • • Check WeChat Pay transaction limit


Troubleshooting: Alipay not working

Key points

  • • Check Alipay is enabled in QFPay account

  • • Confirm customer using official Alipay app

  • • Check Alipay account is verified and has sufficient balance

  • • Try with different Alipay account

  • • Check Alipay transaction limit


Troubleshooting: Refund failed

Key points

  • • Check original transaction has been settled

  • • Confirm refund amount does not exceed original amount

  • • Check refund deadline (usually within 180 days)

  • • View error logs to identify cause

  • • Contact QFPay support if issue persists


Frequently Asked Questions

Key points

  • • Does QFPay work outside China? - Yes, QFPay operates in many Asian countries

  • • What are QFPay transaction fees? - Depends on merchant contract, typically 1-3%

  • • Which account can receive money? - Bank account registered with QFPay

  • • How long is settlement time? - Usually T+1 or T+2 business days

  • • Does QFPay support international payments? - Yes, supports multi-currency

  • • Can I use QFPay for online orders? - Yes, QFPay supports both online and offline

  • • Does Self Order work when QFPay is offline? - Orders can still be created, but cannot pay


Business Benefits

Key points

  • • Expand Chinese and Asian customer market

  • • Increase sales by 35% from Asian tourists

  • • Reduce payment barriers, customers shop more easily

  • • Auto-reconcile transactions, reduce accounting errors

  • • Support multi-currency, auto exchange rate conversion

  • • Increase customer experience with familiar payment methods

  • • Reduce cash and traditional credit card processing costs