跳至主要內容

退款异步通知


服务端接收到支付提供方退款通知之后返回。
如果申请退款时没有传入通知接收地址,则不发起通知请求。

相关信息

需要退款时提供 notify_url

名称类型描述要求
notify_typeString(30)通知类型
固定:trade_status_sync
trade_typeString(10)交易类型
REFUND
user_confirm_keyString用户Key,由 eftPay 提供
transaction_idString(64)支付提供方单号
trade_noString(64)支付提供方单号
out_trade_noString(28)商户订单号
total_feeString(8)订单总金额
currencyString(5)货币类型
trade_statusString(32)交易状态,见 附录2
gmt_paymentString交易时间,格式:yyyy-MM-dd HH:mm:ss
walletString(20)钱包类型
tidString(20)商户终端号
eft_trade_noString(28)依付得订单号
eftpay_trade_noString(28)依付得订单号
return_amountString(8)退款金额
refund_noString(28)退款单号
rejectReasonString(28)八达通退款失败原因,只有八达通才会返回这个字段
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": "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"
}