POS Self Order QFPay
Integrate QFPay with Odoo POS self-service ordering system. Support WeChat Pay, Alipay, UnionPay and popular payment methods in Asia.
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