Skip to main content

QR Pay(Merchant-presented)

Merchants with display devices can refer to the solutions provided in this section to access CodePay gateway payments.

Integration Instructions

If a merchant is using a terminal with a display that can dynamically show the order and QR code image, it can be interfaced with the "QR Code Payment" product provided by CodePay.

The so-called "QR code payment (merchant presentation mode)" refers to the merchant providing order information to CodePay, the CodePay system generating prepaid orders, and returning dynamic QR code links to the merchant. Merchants generate QR codes and guide users to scan them using supported mobile wallet applications to complete payments. After the user completes the payment, the merchant can receive a payment notification from CodePay and can also actively call the order query API to obtain payment results. After obtaining the payment result, we will synchronize the order with the merchant to complete the remaining goods and services.

Usage Example

This commonly used payment scenario simulation diagram illustrates the process of users using a mobile wallet to quickly scan the QR code displayed on the merchant terminal and make payments to the merchant

Development Guidelines

We provide a set of REST APIs, please refer to the following table, the APIs are provided with SDKs for several languages, please visit SDK Chapter Description.

Function List Description
Get payment QR codeSubmit a payment order through this api to get the QR code of the payment
Cancel OrderClose unpaid orders through this api and refund the user if payment has already occurred
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 interface 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