跳至主要內容

異步通知與同步返回


  • 服務端接收支付提供方支付通知之後返回。
  • 異步通知需要提供接口 URL 給我們配置到後台,或者預下單時上傳參數 notify_url;同步返回須要預下單時上傳參數 return_url。
    注意: OCT,FDMS,JETCOHK 目前無異步通知只有同步通知,線上銀聯只通知一次,請主動調用查詢獲取訂單狀態。
  • 異步通知商家接口和同步返回商家頁面的請求參數,其中異步通知商家接口的 Content-Type 為 application/json,而同步返回商家頁面的 Content-Type 為 x-www-form-urlencode,POST 提交方式返回給商戶進行接收處理。
  • 接收異步通知後,須返回響應參數,告知已成功接收處理通知。如果是同步返回時,商戶無須返回。

相關信息

需要下單時提供 notify_url / return_url

名稱類型描述要求
notify_typeString(30)通知類型
固定: trade_status_sync
user_confirm_keyString用戶Key,由 eftPay 提供
trade_noString(64)支付提供方單號
transaction_idString(64)支付提供方單號
out_trade_noString(28)商戶訂單號
eft_trade_noString(28)依付得訂單號
eftpay_trade_noString(28)依付得訂單號
total_feeString(8)金額
currencyString(5)貨幣類型
trade_statusString(32)交易狀態,見 附錄2
gmt_paymentString交易時間,格式: yyyy-MM-dd HH:mm:ss
walletString(20)錢包類型
tidString(20)商戶終端號
trade_typeString(10)交易類型
SALE
card_schemeString(8)卡類型,Mpgs 交易配置返回。如:VISA/MASTERCARD
card_numberString(8)卡號,Mpgs 交易配置返回
timeString時間,格式: yyyyMMddHHmmss
signString(64)簽名

名稱類型描述要求
return_statusString(3)返回狀態碼,代表。注:此參數不可作為交易狀態是否成功的判斷
其他狀態碼見 附錄3
return_charString(100)返回說明,可能會變化,不能作條件判斷
return_status 大於 00 時返回
timeString時間,格式: yyyyMMddHHmmss
return_status >= 00 時返回
signString(64)簽名
return_status >= 00 時返回

收到交易異步通知後須返回以下參數

名稱類型描述要求
return_codeString(10)返回碼
success/false
timeString時間,格式: yyyyMMddHHmmss
signString(64)簽名

{
    "notify_type": "trade_status_sync",
    "user_confirm_key": "12345678",
    "trade_no": "2019082422001386450540290447",
    "out_trade_no": "20190824021916",
    "eft_trade_no": "08520005269190824021901723",
    "total_fee": "0.02",
    "currency": "HKD",
    "trade_status": "TRADE_SUCCESS",
    "sign": "d37d17a7243b2ae49a865275531a9a7c42f80623e673d0ccf5a79ef62bf14913",
    "time": "20190824022030",
    "gmt_payment": "2019-09-24 02:20:29",
    "wallet": "ALIPAYCN",
    "trade_type": "SALE"
}

{
    "time": "20230609110646",
    "sign": "2c418bfb1085b0cabbf2f5c6de71db0694a5a78b7271b05ca6d5a8b70227ebb2",
    "return_code": "success"
}