跳轉到主要內容
本文件說明如何透過 QFPay API 搭配 AlipayHK 或 AlipayCN 官方 SDK，整合原生 App 內支付流程。 此方式適用於 iOS / Android 原生 App，可提供無瀏覽器跳轉的流暢支付體驗。
Alipay In App

​
整合流程概覽

  1. App 呼叫 QFPay /trade/v1/payment
  2. QFPay 回傳 pay_params
  3. App 將 pay_params 組裝為 orderInfo
  4. 呼叫 Alipay 官方 SDK 進行支付
  5. 等待非同步通知或查詢交易狀態確認最終結果

​
SDK 下載

請使用官方 SDK 文件與套件：

​
API 請求

Endpoint
POST /trade/v1/payment

​
PayType

PayType說明
801110支付寶 App 內支付（海外商戶 / AlipayCN）
801510支付寶 App 內支付（香港商戶 / AlipayHK）

​
必填參數

參數名稱必填類型說明
txamt是Int交易金額（分）例如 100 = HKD 1
txcurrcd是String(3)幣別，例如 HKD
pay_type是String(6)801110 或 801510
out_trade_no是String(128)商戶唯一訂單號
txdtm是String(20)格式 YYYY-MM-DD HH:mm:ss
goods_name是String商品名稱
return_url是String支付完成回跳網址
seller_id是String支付寶商戶帳號
mchid是String(16)QFPay 指派商戶 ID
通用欄位請參考：
通用支付參數

​
選填參數

參數名稱參數編碼說明
商品描述goods_info支付寶建議填寫，不可含特殊字元
支付標記pay_tag預設 ALIPAYHK；大陸版使用 ALIPAYCN
訂單過期時間expired_time單位分鐘，5–120，預設 30

​
範例請求（Form 格式）

txamt=1
&txcurrcd=HKD
&pay_type=801510
&out_trade_no=052711570017898
&txdtm=2021-05-27 11:57:00
&goods_name=goods_name
&goods_info=goods_info
&mchid=nDB64h9qJ1An
&return_url=https://www.qfpay.global/
&pay_tag=ALIPAYHK
&seller_id=testoverseas9191@alipay.com

​
回傳欄位（pay_params）

QFPay 回傳的 pay_params 需原樣傳入 Alipay SDK。
參數說明
partner合作夥伴 ID
seller_id收款帳號對應用戶號
subject商品標題
body商品描述
total_fee訂單金額
notify_url通知地址
service服務名稱
payment_type支付類型
_input_charset編碼格式
it_b_pay超時參數
return_url回跳網址
currency幣別
product_code產品代碼
signRSA 簽名
sign_type簽名類型

​
QFPay 回傳範例

{
  "respcd": "0000",
  "pay_type": "801510",
  "syssn": "20210527154100020004180921",
  "out_trade_no": "052711570017898",
  "pay_params": {
    "body": "goods_info",
    "seller_id": "2088231067382451",
    "total_fee": 0.01,
    "currency": "HKD",
    "service": "mobile.securitypay.pay",
    "sign_type": "RSA",
    "sign": "xxxxx",
    "product_code": "NEW_WAP_OVERSEAS_SELLER"
  }
}

​
組裝 orderInfo

取得 pay_params 後：
  1. 將參數依 key="value" 格式組合
  2. 按 key 進行 A–Z 排序
  3. 使用 & 連接
  4. 將 sign 與 sign_type 放最後

​
範例

_input_charset="UTF-8"&body="goods_info"&currency="HKD"&partner="2088231067382451"&product_code="NEW_WAP_OVERSEAS_SELLER"&seller_id="2088231067382451"&service="mobile.securitypay.pay"&total_fee="0.01"&sign="xxxxx"&sign_type="RSA"
  • 必須使用對應地區 SDK（HK 或 CN）
  • pay_params 內所有 key 與 value 必須保持完全一致
  • 簽名驗證邏輯需符合支付寶官方 SDK 規範
  • 最終交易結果請以非同步通知或交易查詢 API 為準