QFPay for POS
Accept WeChat Pay, Alipay, and Chinese e-wallets at your POS checkout. Expand international customer base and increase revenue from tourists and Chinese communities.
Overview
POS QFPay module integrates QFPay payment gateway into Odoo Point of Sale system, enabling stores to accept payments from WeChat Pay, Alipay, and popular Chinese e-wallets.
Ideal solution for retail stores, restaurants, hotels serving Chinese tourists and Chinese communities in Vietnam.
Key Features
Key points
• WeChat Pay - Scan QR code to pay via WeChat app
• Alipay - Accept payments from China's most popular e-wallet
• UnionPay - Support UnionPay cards and e-wallet
• Dynamic QR code - Generate unique QR code for each transaction
• Instant payment confirmation - Receive payment success notification immediately
• Multi-currency - Support payments in CNY, VND, and other currencies
• Transaction reports - Track detailed QFPay transactions in Odoo
• Refunds - Process refunds directly from POS
Target Users
Key points
• Retail stores - Serve Chinese tourists and Chinese communities
• Restaurants - Accept mobile payments for international customers
• Hotels - Payment for rooms and services via WeChat Pay/Alipay
• Duty-free shops - Serve tourists with familiar payment methods
• Shopping malls - Enhance shopping experience for international customers
How to Use
Steps
1. Register QFPay merchant account at qfpay.com
2. Get API credentials (Merchant ID, Secret Key) from QFPay dashboard
3. Install POS QFPay module in Odoo: Apps → search "POS QFPay" → Install
4. Configure QFPay: Point of Sale → Configuration → Payment Methods
5. Create new Payment Method, select "QFPay" as Payment Terminal
6. Enter Merchant ID, Secret Key, and configuration details
7. Select payment types: WeChat Pay, Alipay, or both
8. Save configuration and add Payment Method to POS
9. Open POS session, select products and click Payment
10. Choose QFPay payment method (WeChat/Alipay)
11. Display QR code for customer to scan with phone
12. Wait for payment confirmation
13. Complete order and print receipt
Scenario 1: Chinese tourist shopping
Customer from China wants to pay with WeChat Pay as they don't carry cash or international cards.
Staff selects WeChat Pay, displays QR code, customer scans and pays in seconds. Transaction completes quickly without complex currency exchange.
Scenario 2: Restaurant serving international customers
Group of Chinese customers dining at restaurant, want to split bill and pay separately with Alipay.
Staff creates multiple separate orders, each person scans Alipay QR code to pay their share. Convenient and fast.
Scenario 3: Duty-free shop at airport
Customer shopping duty-free before flight, needs quick payment.
Use QFPay to accept WeChat Pay/Alipay, transaction completes in seconds, customer doesn't miss flight.
Scenario 4: Refund to customer
Customer returns product purchased with WeChat Pay.
Staff processes refund directly from POS, money automatically refunded to customer's WeChat wallet.
Scenario 5: Multi-currency payment
Customer wants to pay in CNY while store uses VND.
QFPay automatically converts currency at real-time exchange rate, customer pays in CNY, store receives VND.
Important Terminology
Key points
• QFPay - Mobile payment gateway supporting WeChat Pay, Alipay, and Chinese e-wallets
• WeChat Pay - E-wallet integrated in WeChat app, most popular in China
• Alipay - Alibaba's e-wallet, widely used in China and internationally
• QR Code Payment - Payment by scanning QR code displayed on POS screen
• Merchant ID - Unique identifier for store on QFPay system
• Payment Terminal - Device or software processing payments at checkout
• Settlement - Process of transferring money from QFPay to merchant's bank account
Tips for Effective Use
Key points
• Display WeChat Pay/Alipay logos at checkout so customers know you accept them
• Train staff on quick QFPay payment processing
• Check stable internet connection to avoid payment interruptions
• Set reasonable timeout (30-60 seconds) for each transaction
• Print receipts with QFPay transaction info for customer reference
• Check settlement reports regularly to reconcile revenue
• Prepare backup payment methods when QFPay has issues
• Use test mode before official deployment
System Requirements
Key points
• Activated QFPay merchant account
• Valid API credentials (Merchant ID, Secret Key)
• Point of Sale module installed in Odoo
• Stable internet connection at point of sale
• Display screen for QR code (POS screen or secondary display)
• Odoo 15.0 or higher (recommended Odoo 17 or 19)
Troubleshooting: Cannot connect to QFPay
Key points
• Check API credentials: Merchant ID and Secret Key correct
• Check internet connection at POS
• Confirm QFPay account is activated and not locked
• 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 Payment Method configured correctly
• Ensure payment amount within allowed limits
• Check currency supported by QFPay
• Restart POS session
• Clear browser cache and reload POS
Troubleshooting: Payment not confirmed
Key points
• Wait a few more seconds, may be network delay
• Check transaction status on QFPay dashboard
• Don't create new transaction until old one confirmed
• If timeout, check QFPay dashboard before refunding
• Contact QFPay support with Transaction ID for inquiry
Troubleshooting: Refund failed
Key points
• Check original transaction already settled (usually after 1-2 days)
• Ensure refund amount not exceeding original amount
• Check merchant account has sufficient balance for refund
• View error details in Odoo log
• Contact QFPay support for manual refund processing
Frequently Asked Questions
Key points
• Does QFPay charge transaction fees? - Yes, usually 1-3% depending on service plan. Contact QFPay for details
• How long to receive money from QFPay? - Usually T+1 or T+2 (1-2 business days after transaction)
• Is there transaction amount limit? - Yes, depends on merchant account configuration and e-wallet type
• Do customers need Chinese account? - Not necessarily, many e-wallets now support international users
• Does QFPay work offline? - No, internet connection required to process transactions
• Can partial refunds be made? - Yes, supports partial or full refunds
• Is QFPay secure? - Yes, QFPay complies with PCI DSS security standards and is licensed in many countries
Business Benefits
Key points
• Expand Chinese customer market and Chinese communities
• Increase revenue from international tourists
• Reduce risk of counterfeit money and credit card fraud
• Fast payments, reduce checkout waiting time
• No need to invest in expensive POS equipment, just display screen for QR
• Automatic transaction reconciliation, reduce accounting work
• Enhance customer experience with familiar payment methods