跳轉到主要內容
CPM Flow

​
什麼是 CPM？

CPM（Consumer Presented Mode）指顧客出示付款碼，由商戶掃描完成付款。 常見流程：
  1. 顧客在錢包（WeChat Pay / Alipay / PayMe / 銀聯雲閃付）打開付款碼（動態 QR Code / 條碼）
  2. 商戶使用收銀設備掃描顧客付款碼
  3. 系統回傳交易結果；若仍處理中，商戶需再查詢狀態確認

​
CPM API 請求

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

​
支援的支付類型（PayType）

編碼說明
800008微信、支付寶、銀聯雲閃付、PayMe 反掃支付
800108支付寶跨境反掃支付
800208微信反掃支付
801008微信香港反掃支付（適用於向微信香港申請的商戶）
805808PayMe 反掃支付
800708銀聯雲閃付反掃支付
若回傳代碼為 1143 / 1145，表示交易仍在處理中，或顧客正在輸入密碼。建議使用 交易查詢 API 再次確認最終狀態。
簽名生成方式請參考 簽名生成。

​
請求示例

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

auth_code=13485790*******88557&goods_name=qfpay&mchid=R1zQrTdJnn&out_trade_no=Native201907221520536a25477909&pay_type=800208&txamt=10&txcurrcd=HKD&txdtm=2019-07-22 15:20:54&udid=AA

​
回應示例

{
  "pay_type": "800108",
  "sysdtm": "2019-07-22 15:20:54",
  "paydtm": "2019-07-22 15:20:56",
  "txdtm": "2019-07-22 15:20:54",
  "udid": "AA",
  "txcurrcd": "EUR",
  "txamt": 10,
  "resperr": "交易成功",
  "respmsg": "OK",
  "out_trade_no": "201907221520536a25477909",
  "syssn": "20190722000300020081074842",
  "respcd": "0000",
  "chnlsn": "4200000384201907223585006133"
}

​
請求參數

欄位必填類型說明
通用支付請求參數——通用欄位，例如 mchid、txamt、txcurrcd、out_trade_no 等
auth_code是（僅限 CPM）String(128)顧客錢包付款碼（條碼 / 二維碼）的授權碼；每筆交易唯一（通常可在付款碼下方看到）

​
回應參數

欄位類型說明
通用回應格式—回應結構包含 respcd、syssn、respmsg 等欄位