異步通知與同步返回
- 服務端接收支付提供方支付通知之後返回。
- 異步通知需要提供接口 URL 給我們配置到後台,或者預下單時上傳參數 notify_url;同步返回須要預下單時上傳參數 return_url。
注意: OCT,FDMS,JETCOHK 目前無異步通知只有同步通知,線上銀聯只通知一次,請主動調用查詢獲取訂單狀態。 - 異步通知商家接口和同步返回商家頁面的請求參數,其中異步通知商家接口的 Content-Type 為 application/json,而同步返回商家頁面的 Content-Type 為 x-www-form-urlencode,POST 提交方式返回給商戶進行接收處理。
- 接收異步通知後,須返回響應參數,告知已成功接收處理通知。如果是同步返回時,商戶無須返回。
相關信息
需要下單時提供 notify_url
/ return_url
名稱 | 類型 | 描述 | 要求 |
---|---|---|---|
notify_type | String(30) | 通知類型 固定: trade_status_sync | |
user_confirm_key | String | 用戶Key,由 eftPay 提供 | |
trade_no | String(64) | 支付提供方單號 | |
transaction_id | String(64) | 支付提供方單號 | |
out_trade_no | String(28) | 商戶訂單號 | |
eft_trade_no | String(28) | 依付得訂單號 | |
eftpay_trade_no | String(28) | 依付得訂單號 | |
total_fee | String(8) | 金額 | |
currency | String(5) | 貨幣類型 | |
trade_status | String(32) | 交易狀態,見 附錄2 | |
gmt_payment | String | 交易時間,格式: yyyy-MM-dd HH:mm:ss | |
wallet | String(20) | 錢包類型 | |
tid | String(20) | 商戶終端號 | |
trade_type | String(10) | 交易類型SALE | |
card_scheme | String(8) | 卡類型,Mpgs 交易配置返回。如:VISA /MASTERCARD | |
card_number | String(8) | 卡號,Mpgs 交易配置返回 | |
time | String | 時間,格式: yyyyMMddHHmmss | |
sign | String(64) | 簽名 |
名稱 | 類型 | 描述 | 要求 |
---|---|---|---|
return_status | String(3) | 返回狀態碼,代表。注:此參數不可作為交易狀態是否成功的判斷 其他狀態碼見 附錄3 | |
return_char | String(100) | 返回說明,可能會變化,不能作條件判斷 | |
time | String | 時間,格式: yyyyMMddHHmmss return_status >= 00 時返回 | |
sign | String(64) | 簽名return_status >= 00 時返回 |
收到交易異步通知後須返回以下參數
名稱 | 類型 | 描述 | 要求 |
---|---|---|---|
return_code | String(10) | 返回碼 success/false | |
time | String | 時間,格式: yyyyMMddHHmmss | |
sign | String(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"
}