跳至主要內容

退款異步通知


服務端接收到支付提供方退款通知之後返回。

目前只支援微信。

相關信息

需要退款時提供 notify_url

名稱類型描述要求
notify_typeString(30)通知類型
固定:trade_status_sync
trade_typeString(10)交易類型
REFUND
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)貨幣類型
return_amountString(8)退款金額
refund_noString(28)退款單號
trade_statusString(32)交易狀態,見 附錄2
gmt_paymentString交易時間,格式:yyyy-MM-dd HH:mm:ss
walletString(20)錢包類型
tidString(20)商戶終端號
timeString時間,格式:yyyyMMddHHmmss
signString(64)簽名

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

名稱類型描述要求
return_codeString(10)返回碼
success/false
timeString時間,格式:yyyyMMddHHmmss
signString(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": "rrn_1686280005985",
    "refund_no": "R_rrn_1686280005985",
    "return_amount": "0.29",
    "time": "20230609110645",
    "total_fee": "0.29",
    "trade_no": "4200000994202001206533192063",
    "trade_status": "TRADE_CLOSED",
    "trade_type": "REFUND",
    "transaction_id": "4200000994202001206533192063",
    "user_confirm_key": "S0003469",
    "wallet": "WECHATCN",
    "sign": "b4fcff1e7bb7e3acb6dcdf4a5058776f33bee8313ef43674b1e4b9dcfcbb6d11"
}

{
    "time": "20230609110645",
    "sign": "8e80d3a03a8cf23e1427648fdf160431188740fbc371090c702c5a00bb6f347b",
    "return_code": "success"
}