Skip to main content

QR Payment

QR payment includes two modes:

MPM (Merchant Presented Mode)​

In MPM mode, the merchant generates and displays the QR code, and the customer uses their mobile wallet app to scan the code and complete the payment. The detailed process is as follows:

  1. The merchant system submits an order payment request to CodePay Gateway.
  2. CodePay Gateway processes the payment request and returns the QR code generated by the mobile wallet system to the merchant system.
  3. The merchant system displays the QR code.
  4. The customer uses their mobile wallet app to scan the QR code and complete the payment.
  5. The merchant system receives the payment result notification, updates the order status, and informs the merchant to deliver the goods or services.
Flowchart for Scan-to-Pay MPM Mode (Merchant Presents QR Code)

Use Case Diagram for Scan-to-Pay MPM Mode (Merchant Presents QR Code)

CPM (Customer Presented Mode)​

In CPM mode, the customer generates a QR code using their mobile wallet app and presents it to the merchant. The detailed process is as follows:

  1. The customer generates and shows a QR code using their mobile wallet app.
  2. The merchant scans the QR code using their system.
  3. The merchant system submits an order payment request to CodePay Gateway with the QR code.
  4. CodePay Gateway processes the payment and get payment result, sends result notification to the merchant system.
  5. The merchant system updates the order status and confirms the payment. The merchant delivers the goods or services to the customer.
Flowchart for Scan-to-Pay CPM Mode (Customer Presents QR Code)

Use Case Diagram for Scan-to-Pay CPM Mode (Customer Presents QR Code)

Developer Guide​

API List​

The following table provides an overview of the QR payment related APIs.

Function List Description
MPM (Merchant Presented Mode) - Get payment QR codeSubmit a payment order through this API to get the QR code of the payment
CPM (Customer Presented Mode) - Submit Payment Request. codeSubmit a payment request through this API.
Submit a refund requestIf you submit a refund request through this API and the refund does not arrive immediately, you can call the refund inquiry API to get the progress of the refund.
Query orderQuery the transaction result (consumption/pre-authorization/pre-authorization completion) of a positive transaction order through this API
Query refundQuery the transaction results of negative transaction orders (consumption cancellation/pre-authorization cancellation/consumption refund/pre-authorization completion refund) through this API
Transaction result notificationAfter the transaction, notify the merchant through this webhook to tell the merchant the result of the transaction

Quick Integration SDK​

To simplify the integration process, we also provide SDKs or demos for several languages (see SDK/Demo section). These SDKs handle most of the necessary functionality, making the implementation of QR code payment processes easier.