退款異步通知
服務端接收到支付提供方退款通知之後返回。
如果申請退款時沒有傳入通知接收地址,則不發起通知請求。
相關信息
需要退款時提供 notify_url
名稱 | 類型 | 描述 | 要求 |
---|---|---|---|
notify_type | String(30) | 通知類型 固定: trade_status_sync | |
trade_type | String(10) | 交易類型REFUND | |
user_confirm_key | String | 用戶Key,由 eftPay 提供 | |
transaction_id | String(64) | 支付提供方單號 | |
trade_no | String(64) | 支付提供方單號 | |
out_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) | 商戶終端號 | |
eft_trade_no | String(28) | 依付得訂單號 | |
eftpay_trade_no | String(28) | 依付得訂單號 | |
return_amount | String(8) | 退款金額 | |
refund_no | String(28) | 退款單號 | |
rejectReason | String(28) | 八達通退款失敗原因,只有八達通才會返回這個字段 | |
time | String | 時間,格式:yyyyMMddHHmmss | |
sign | String(64) | 簽名 |
收到交易通知後須返回以下參數
名稱 | 類型 | 描述 | 要求 |
---|---|---|---|
return_code | String(10) | 返回碼 success/false | |
time | String | 時間,格式:yyyyMMddHHmmss | |
sign | String(64) | 簽名 |
{
"currency": "HKD",
"eft_trade_no": "18520003650610023041t5ruq5va732",
"eftpay_trade_no": "18520003650610023041t5ruq5va732",
"gmt_payment": "2020-01-20 10:35:34",
"notify_type": "trade_status_sync",
"out_trade_no": "20200120103448",
"refund_no": "R_20200120103526_0",
"return_amount": "0.02",
"time": "20200120110948",
"total_fee": "0.02",
"trade_no": "4200000994202001206533192063",
"trade_status": "TRADE_CLOSED",
"trade_type": "REFUND",
"transaction_id": "4200000994202001206533192063",
"user_confirm_key": "61002304",
"wallet": "WECHATCN",
"sign": "13a0a514971ded891920554346b5c83362f58dd7580554f3ef66f9859fbfe916"
}
{
"time": "20230609110646",
"sign": "2c418bfb1085b0cabbf2f5c6de71db0694a5a78b7271b05ca6d5a8b70227ebb2",
"return_code": "success"
}