跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://sdk.qfapi.com/llms.txt

Use this file to discover all available pages before exploring further.

MPM Flow

​
什麼是 MPM？

MPM（Merchant Presented Mode）指商戶出示付款碼，由顧客掃描完成付款。 典型流程：
  1. 商戶系統產生動態 QR Code
  2. 將 QR Code 展示於 POS / 收銀畫面
  3. 顧客使用電子錢包掃描
  4. 交易完成後系統回傳結果
此模式適用於：
  • 線下實體門店
  • 線上頁面啟動付款（展示 QR Code 供掃描）

​
MPM API 請求

  • 端點：/trade/v1/payment
  • 方法：POST

​
支援的支付類型（PayType）

編碼說明
800101支付寶跨境線下掃碼支付
801501支付寶線上掃碼支付（香港商戶）
800201微信掃碼支付
805801PayMe 掃碼支付
800701銀聯雲閃付掃碼支付
802001香港轉數快掃碼支付
803701八達通動態二維碼掃碼支付（香港商戶）
簽名生成方式請參考 簽名生成

​
請求範例

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

​
回應範例

{
  "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": ""
}

​
請求參數

欄位必填類型說明
通用請求參數——通用欄位，例如 mchid、txamt、txcurrcd、out_trade_no 等
pay_tag否String(16)錢包標示。預設 ALIPAYHK，中國大陸使用者為 ALIPAYCN
expired_time否String(3)QR 碼有效時間（單位：分鐘，範圍 5–120）。預設 30 分鐘。僅適用於 Alipay / WeChat
limit_pay否String設為 no_credit 可禁用信用卡付款（僅適用於中國大陸錢包）

​
回應參數

欄位類型說明
qrcodeString(512)生成的 QR Code 連結
通用回應格式—包含 respcd、syssn、respmsg 等欄位