Chinese QR Payment Gateway
Accept payments through QR codes with static and dynamic QR generation, payment API integration, and centralized collection management through your merchant dashboard.
What is a QR Payment Gateway?
A payment processing solution built around QR code collection.
A QR payment gateway is a payment platform that enables merchants to collect payments using QR codes. Customers scan a QR code with their payment app, confirm the amount, and complete the transaction in seconds without entering card details or bank information.
QR payments are one of the most widely adopted digital payment methods. The gateway handles QR code generation, payment confirmation, settlement processing, and reporting so merchants can offer QR collections without building the infrastructure themselves.
QR payment processing is one component of a broader payment strategy. For an overview of all available services, see our Chinese payment gateway page . For UPI-specific QR details, see our UPI payment gateway page .
QR Payment Flow
How QR Payments Work
A general overview of the QR payment flow for merchants and customers.
QR payment processing begins when a merchant generates or displays a QR code. For dynamic payments, the merchant's system calls the QR generation API with the amount and reference, receiving a QR code image or encoded data in response.
The customer opens their payment application, selects the scan function, and points their camera at the QR code. The app decodes the payment information and displays the transaction details. The customer reviews and confirms the payment, authorizing it with their security credentials.
The gateway receives the confirmation from the payment network and sends a webhook notification to the merchant's server. The merchant's system can then fulfill the order, update the customer, and record the transaction. Settlements follow the agreed cycle, with all QR payments grouped into regular payouts.
Static QR vs Dynamic QR
Understanding the differences and choosing the right approach.
Static QR Codes
A static QR code is a fixed code that always points to the same payment destination. The customer scans the code, enters the amount manually, and completes the payment. Static codes never expire and can be printed on receipts, menus, or displayed at point-of-sale locations.
Dynamic QR Codes
A dynamic QR code is generated per transaction and contains specific details including the exact amount, a unique reference ID, and an expiry time. When scanned, the payment app pre-fills all information, reducing customer errors and enabling automatic reconciliation.
| Factor | Static QR | Dynamic QR |
|---|---|---|
| Amount Entry | Customer enters amount manually | Amount pre-set at generation time |
| Reconciliation | Manual — based on customer-declared reference | Automatic — unique per-transaction reference |
| Expiry | No expiry — remains valid indefinitely | Configurable expiry (minutes to hours) |
| Customization | Limited — typically standard format only | Brandable — logos, colors, and styling supported |
| Use Case | Storefronts, fixed locations, small merchants | Checkout, invoices, events, time-sensitive payments |
| Tracking | Limited — cannot distinguish individual scans | Full — each scan tied to a unique reference |
| Generation Cost | One-time setup, reusable forever | Generated per transaction, minor overhead per code |
Many merchants use both types — static for walk-in or recurring customers and dynamic for online checkout and time-sensitive collections.
Key Features
QR payment capabilities available through the gateway.
Dynamic QR Generation
Generate unique QR codes per transaction with embedded amount, reference, and expiry time for automated reconciliation.
Static QR Codes
Create permanent QR codes linked to your merchant account for fixed-location collections where customers enter the amount manually.
QR Generation API
RESTful API for programmatic QR code generation with configurable amount, expiry, reference, and callback parameters.
Merchant Dashboard
Central interface for viewing QR payment collections, managing generated codes, and monitoring transaction activity.
Transaction Reports
Detailed reports showing QR payment volumes, success rates, settlement amounts, and fee breakdowns for accounting reconciliation.
Webhook Notifications
Receive real-time updates when a QR code is scanned and payment completes, enabling automated order fulfillment without polling.
Developer Documentation
Comprehensive API reference, QR integration guides, code samples, and SDKs to help your team implement QR payments.
Settlement Reports
Settlement summaries showing all QR payments included in each payout cycle, with reconciliation data for your accounting team.
Business Use Cases
Common scenarios where QR payment collection adds value.
Retail & Ecommerce
Online stores use dynamic QR codes at checkout for quick payment. Physical retailers display static QR codes at registers for walk-in customer payments.
Restaurants & Hospitality
Restaurants place static QR codes on tables or receipts for bill payment. Customers scan, enter the amount, and pay without waiting for staff.
Gaming & Digital Services
Gaming platforms use dynamic QR codes for player deposits. Digital service providers generate QR codes per invoice for one-time or subscription payments.
For additional business scenarios, see our payment gateway overview and India solutions page .
Integration Process
Steps to get QR payment collection working on your platform.
Merchant Registration
Submit your business details and complete verification to activate your merchant account for QR collections.
API Access
Receive API credentials, review QR generation documentation, and configure webhook endpoints for payment confirmations.
QR Generation
Integrate the QR generation API to create dynamic codes or configure static codes for your collection points.
Testing
Test QR generation, scanning flows, webhook delivery, and expiry handling in the sandbox environment.
Production Deployment
Switch to production, generate live QR codes, and start collecting payments with real-time dashboard visibility.
Common Mistakes in QR Payment Implementation
Issues merchants encounter when deploying QR payment collection.
QR Code Too Small or Poorly Displayed
Codes that are too small, low contrast, or displayed on reflective surfaces fail to scan. Ensure QR codes are at least 2 x 2 cm with adequate contrast and matte finish for reliable scanning.
No Expiry Handling for Dynamic Codes
Displaying expired dynamic QR codes without clear messaging confuses customers. Implement a fallback that generates a fresh code or offers an alternative payment method when a code expires.
Missing Scan Feedback Loop
Customers who scan and pay need visual confirmation that their payment was received. Build a feedback mechanism that updates the interface once the webhook confirms the transaction.
Ignoring Error State Handling
Network failures, expired codes, and declined payments need specific handling. Test each error scenario during integration so your system responds gracefully instead of showing generic failures.
Using Only One QR Type
Relying solely on static or dynamic QR limits your collection flexibility. Combining both types lets you serve walk-in customers, online checkout, and invoice payments from a single integration.
Best Practices for QR Payment Integration
Approaches that lead to a reliable QR collection experience.
Set Appropriate QR Expiry Durations
Match QR expiry to your payment context. Checkout pages benefit from 10 to 15 minute windows while invoices may need several hours. Shorter expiries reduce stale-code issues.
Display QR Codes with Clear Instructions
Add a short instruction next to the QR code telling customers which app to use and what to do. This reduces confusion and support requests, especially for first-time QR payers.
Implement QR Code Caching Strategically
Cache generated QR images temporarily to reduce API calls for frequently accessed codes, but balance caching duration against the need for fresh expiry times on dynamic codes.
Test with Multiple Scanning Apps
Different payment apps handle QR decoding slightly differently. Test your generated QR codes with multiple popular apps in the market to ensure broad compatibility.
Monitor QR Payment Success Rates
Track how many generated QR codes result in completed payments. A low conversion rate may indicate issues with code design, expiry settings, or the checkout experience that need adjustment.
QR Implementation Checklist
A practical checklist to review before launching QR payment collection.
| Task | Phase |
|---|---|
| Register merchant account and verify business details | Prerequisite |
| Determine QR strategy — static, dynamic, or both | Planning |
| Review QR generation API documentation and endpoints | Setup |
| Configure webhook URLs for payment confirmation callbacks | Setup |
| Implement dynamic QR generation for checkout flows | Development |
| Set up static QR display for fixed-location collections | Development |
| Build scan feedback — confirm payment to customer in real-time | Development |
| Handle QR expiry scenarios with clear user messaging | Development |
| Test complete scan-to-confirmation flow in sandbox | Testing |
| Verify webhook delivery and reconciliation for QR payments | Testing |
| Deploy to production and monitor first QR collections | Launch |
| Set up dashboard alerts for failed or unusual QR transactions | Post-Launch |
Security Best Practices
General security considerations for QR payment processing.
QR payment security starts with ensuring that generated codes contain valid, unmodified payment data. The gateway signs all payment requests so customers can verify they are paying the intended merchant and amount.
Merchants should display QR codes in trusted contexts — on their own checkout pages, printed materials, or controlled physical locations. Tampered or replaced QR codes can redirect payments, so physical code displays should be secured against unauthorized replacement.
On the integration side, webhook endpoints that receive QR payment confirmations should verify signatures before processing the data. API credentials used for QR generation should be stored securely and never exposed in client-side code.
Signed QR Payloads
QR code data includes cryptographic signatures that prevent tampering with payment details.
Secure Display
Display codes in trusted environments to prevent physical tampering or replacement with fraudulent codes.
Webhook Verification
Validate webhook signatures on every incoming notification to confirm authenticity before processing the payment data.
Benefits
What merchants gain from a dedicated QR payment gateway.
Fast Payment Collection
Customers complete payments in seconds by scanning a code, reducing checkout friction and improving conversion rates.
Easy Integration
Simple API calls for QR generation with clear documentation make integration accessible for development teams of any size.
Developer-Friendly APIs
RESTful QR generation APIs with code samples, SDKs, and webhook support for building custom payment flows.
Scalable Infrastructure
The platform handles increasing QR payment volumes as your business grows, supporting both low and high transaction counts.
Flexible Collection Options
Support both static and dynamic QR codes from a single integration, covering walk-in, online, and invoice payment scenarios.
Full Visibility
Dashboard and reports show QR payment performance, settlement summaries, and collection trends for business tracking.
Next Steps
Ready to start accepting QR payments?
Also explore our provider guide , agent panel , and merchant gateway for complementary tools.
Frequently Asked Questions
Common questions about QR payment gateway integration and operation.
Have more questions? Visit our contact page or read about Chinese payment gateway and India solutions .
Ready to Collect Payments via QR?
Talk to our team about setting up QR payment collection for your business. We will walk you through the integration process and answer your questions.