Skip to main content

​
Merchant Present Mode (MPM)

MPM process-flow

​
MPM API Request

Endpoint : /trade/v1/payment
Method : POST

​
Supported PayTypes

PayTypeDescription
800101Alipay MPM (Overseas Merchants)
801501Alipay MPM (HK Merchants)
800201WeChat MPM (Overseas & HK Merchants)
805801PayMe MPM (HK Merchants)
800701UNIONPAY Quick Pass MPM
802001FPS MPM (HK Merchants)
803701Octopus Dynamic QRC MPM (HK Merchants)

​
Scenario

The merchant generates a dynamic QR code based on Alipay or WeChat Pay protocol and displays it for the customer to scan. Customers complete the payment by scanning the QR code using their wallets. This applies to:
  • Offline POS environments
  • Online browser-initiated flows
Refer to Signature Generation for signing instructions.

​
Example Request

HTTP
POST /trade/v1/payment HTTP/1.1
Content-Type: application/x-www-form-urlencoded
X-QF-APPCODE: A6A49A66B4C********94EA95032
X-QF-SIGN: 3b020a6349646684ebeeb0ec2cd3d1fb

expired_time=10&goods_name=qfpay&limit_pay=no_credit&mchid=R1zQrTdJnn&out_trade_no=Native20190722145741431794b8d1&pay_type=800201&txamt=20&txcurrcd=HKD&txdtm=2019-07-22 14:57:42&udid=AA

​
Example Response

JSON
{
  "surcharge_fee": 0,
  "qrcode": "https://qr.alipay.com/bax03190uxd47wbekffy6033",
  "pay_type": "800101",
  "surcharge_rate": 0,
  "resperr": "success",
  "txdtm": "2020-04-23 11:09:24",
  "out_trade_no": "364ZK6BAJGYHMU3TUX0X7MGIGQL4O8KI",
  "syssn": "20200423066200020000976054",
  "sysdtm": "2020-04-23 11:09:27",
  "txcurrcd": "EUR",
  "respmsg": "",
  "chnlsn2": "",
  "cardcd": "",
  "udid": "qiantai2",
  "txamt": "1",
  "respcd": "0000",
  "chnlsn": ""
}

​
Request Parameters

FieldRequiredTypeDescription
Public Parameters——Common fields like mchid, txamt, etc.
pay_tagNoString(16)Wallet specifier. Default: ALIPAYHK. Mainland Alipay: ALIPAYCN
expired_timeNoString(3)QR code expiry in minutes (5–120). Default is 30. Only for WeChat/Alipay
limit_payNoStringUse no_credit to disable credit cards. Applicable to CN wallets only

​
Response Parameters

FieldTypeDescription
qrcodeString(512)Generated QR code URL
Common Parameters—Common fields like respcd, syssn, etc.