跳到主要内容

支付寶 App 內支付（Alipay In-App）

本文件說明如何使用支付寶 SDK（AlipayHK 或 AlipayCN）整合 App 內支付。此支付方式適用於原生 App 環境，提供流暢且無跳轉的使用者支付體驗。

Alipay APP Payment process-flow

SDK 下載​

請先下載官方 SDK 套件以開始整合：

HTTP 請求​

接口位址：/trade/v1/payment
HTTP 方法：POST

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

必填參數​

參數名稱是否必填類型說明
txamt是Int交易金額（單位：分），例如 100 = $1
txcurrcd是String(3)幣別代碼（如：HKD）
pay_type是String(6)Alipay CN 使用 801110，AlipayHK 使用 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否String支付寶必填，且不得包含特殊字符
支付標記pay_tag否String(16)預設為 ALIPAYHK
若為支付寶大陸版本請傳值：ALIPAYCN
訂單過期時間expired_time否
(僅限主掃支付)		String(3)以分鐘為單位的過期時間。預設為 30 分鐘，最小值為 5 分鐘，最大值為 120 分鐘
適用於微信與支付寶

範例請求（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
&trade_name=trade_name
&goods_detail=goods_detail
&return_url=https://www.qfpay.global/
&pay_tag=ALIPAYHK
&seller_id=testoverseas9191@alipay.com

回傳欄位（pay_params）​

以下欄位由 QFPay 回傳，需原樣傳入支付寶 SDK 使用：

參數編碼二級參數編碼參數名稱
pay_paramspartner合作夥伴
seller_id收款支付寶帳號對應的支付寶唯一用戶號
subject商品標題／交易標題／訂單標題／關鍵詞等
body對該筆交易的具體描述；若為多件商品，請將商品描述合併傳入 body
total_fee訂單總金額
notify_url通知位址
service服務名稱
cardcd卡號
payment_type支付類型
_input_charset編碼格式
it_b_pay自訂超時參數
return_url回跳頁面目標位址
payment_inst支付機構
currency幣別
product_code產品代碼
signRSA 簽名值（必填）
sign_type簽名類型
secondary_merchant_id二級商戶編號
secondary_merchant_name二級商戶名稱
secondary_merchant_industry二級商戶所屬行業
chnlsn通道交易編號
常用回應參數——

QFPay 回傳範例​

{
  "pay_type": "801510",
  "sysdtm": "2021-05-27 11:57:02",
  "paydtm": "2021-05-27 11:57:02",
  "udid": "qiantai2",
  "txcurrcd": "HKD",
  "txdtm": "2021-05-27 11:57:00",
  "txamt": "1",
  "resperr": "交易成功",
  "respmsg": "",
  "out_trade_no": "052711570017898",
  "syssn": "20210527154100020004180921",
  "pay_params": {
    "body": "goods_info",
    "forex_biz": "FP",
    "seller_id": "2088231067382451",
    "secondary_merchant_id": "1000007081",
    "service": "mobile.securitypay.pay",
    "payment_inst": "ALIPAYHK",
    "it_b_pay": "30m",
    "secondary_merchant_name": "IFlare Hong Kong Limited (external) - online",
    "_input_charset": "UTF-8",
    "sign": "iU1yXUnsCK7rJAu0DoN61arVexbIfo3GLR5jr3QzjkZ29INSPhcA4e%2F2%2BdPrsf5huzQAkxVKP0CTfvaGPMYqNkxmhoaJWUH0ZhgYDgKugMvtweBvRqOX2W0h3A%2F%2FIdJuxeyOAuh7bHiuazSB3ZH%2BEQwRGP%2Bkk8Jpha930gHwPtw%3D",
    "currency": "HKD",
    "out_trade_no": "20210527154100020004180921",
    "payment_type": "1",
    "total_fee": 0.01,
    "sign_type": "RSA",
    "notify_url": "https://test-o2-hk.qfapi.com/trade/alipay_hk/v1/notify",
    "partner": "2088231067382451",
    "secondary_merchant_industry": "5941",
    "product_code": "NEW_WAP_OVERSEAS_SELLER",
    "return_url": "https://www.qfpay.global/",
    "subject": "goods_name"
  },
  "respcd": "0000",
  "chnlsn": "",
  "cardcd": ""
}

使用支付寶 SDK​

取得回傳的 pay_params 後，需依以下格式組合成 orderInfo 字串：

  1. 依格式拼接：key="value"
  2. 依 key 值進行字母排序（A-Z）
  3. 使用 & 連接
  4. 將 sign 與 sign_type 放在最後

範例​

_input_charset="UTF-8"&body="goods_info"&currency="HKD"&forex_biz="FP"&it_b_pay="30m"&notify_url="https://test-o2-hk.qfapi.com/trade/alipay_hk/v1/notify"&out_trade_no="20210527154100020004180921"&partner="2088231067382451"&payment_inst="ALIPAYHK"&payment_type="1"&product_code="NEW_WAP_OVERSEAS_SELLER"&return_url="https://www.qfpay.global/"&secondary_merchant_id="1000007081"&secondary_merchant_industry="5941"&secondary_merchant_name="IFlare Hong Kong Limited (external) - online"&seller_id="2088231067382451"&service="mobile.securitypay.pay"&subject="goods_name"&total_fee="0.01"&sign="iU1yXUnsCK7rJAu0DoN61arVexbIfo3GLR5jr3QzjkZ29INSPhcA4e%2F2%2BdPrsf5huzQAkxVKP0CTfvaGPMYqNkxmhoaJWUH0ZhgYDgKugMvtweBvRqOX2W0h3A%2F%2FIdJuxeyOAuh7bHiuazSB3ZH%2BEQwRGP%2Bkk8Jpha930gHwPtw%3D"&sign_type="RSA"

備註

請務必注意：

  • 使用正確地區對應的 SDK（HK 或 CN）
  • pay_params 內的所有 key 與 value 必須完全一致
  • 簽名邏輯需與支付寶 SDK 規範完全相符