Skip to main content
This guide helps merchants choose the appropriate QFPay APIs when accepting payments in physical stores, restaurants, cafés, supermarkets, or any other in-person payment environment. Many real-world deployments require a combination of multiple QFPay APIs rather than a single integration.

​
Suitable For

This integration scenario is recommended for merchants operating:
  • Restaurants
  • Cafés
  • Retail stores
  • Supermarkets
  • Convenience stores
  • Service providers
  • Any business with face-to-face payments

​
Typical Setup

A typical merchant environment may include:
  • A cashier system or ECR
  • A QFPay POS terminal
  • Customer-facing QR codes for ordering or payment
  • A merchant backend for order management and reconciliation

​
Example Solution

​
Restaurant Table QR Ordering

A common restaurant scenario where customers scan a QR code at their table to browse the menu, place orders, and complete payment from their mobile device.
  1. Customer scans the table QR code.
  2. The merchant’s H5 ordering page opens.
  3. Customer places an order.
  4. Merchant backend creates a payment using the H5 / WAP Payment API.
  5. Customer completes payment through the selected wallet or payment method.
  6. Merchant backend receives the payment result through Asynchronous Notifications.
  7. If necessary, the backend verifies the payment result using Transaction Enquiry.
  8. The order status is updated and food preparation begins.

​
Best Practices

Always implementTransaction Enquiry as a fallback mechanism when confirming payment results.Although Asynchronous Notifications should be the primary method for receiving payment results, network issues or customer interruptions may prevent notifications from being received immediately.QFPay recommends:This approach helps prevent orders from remaining in an unknown payment state.
Keep payment processing, order fulfilment, and reconciliation as separate backend processes to improve system reliability and simplify exception handling.

POS API

Integrate cashier systems with QFPay POS terminals.

ECR Integration

Connect ECR systems to QFPay POS terminals.

H5 Payment

Mobile browser payment for QR ordering and self-service payment.

Merchant Present Mode (MPM)

Generate dynamic QR codes for customer wallet payments.

Consumer Present Mode (CPM)

Scan customer wallet barcodes for payment collection.

Transaction Enquiry

Query payment status to confirm transaction results.

Asynchronous Notifications

Receive real-time payment notifications from QFPay.

​
Next Steps

Once you have identified the appropriate integration methods for your business, continue with the corresponding API documentation to begin implementation.