跳至主要內容

退款到賬查詢


可以查詢退款到賬的信息。

目前只支援微信和支付寶。支付寶需要申請權限。

相關信息

{domain}/Servlet/JSAPIService.do

https://vmp.eftpay.com.cn/VMP/Servlet/JSAPIService.do

名稱類型描述要求
serviceString接口名稱
service.unified.RefundStatusQuery
querytypeString(30)查詢類型,固定: OUT_TRADE
eft_trade_noString(28)依付得訂單號
eft_trade_noout_trade_no 二選一
out_trade_noString(28)商戶訂單號
out_trade_noeft_trade_no 二選一
refund_noString(28)商戶退款號
user_confirm_keyString(12)用戶Key,由 eftPay 提供
timeString時間,格式: yyyyMMddHHmmss
signString(64)簽名

提示

  • 優先級 eft_trade_no > out_trade_no

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

名稱類型描述要求
out_trade_noString(28)商戶訂單號
refund_noString(28)商戶退款號
eft_trade_noString(28)依付得訂單號
eftpay_trade_noString(28)依付得訂單號
trade_statusString(32)交易狀態,見 附錄2
refund_statusString(32)退款到賬狀態
SUCCESS - 成功
PROCESSING - 處理中
FAIL - 失敗
recv_accountString(64)退款入賬方,僅微信支援返回,其他交易返回空字符
user_confirm_keyString用戶Key,由 eftPay 提供
trade_typeString(10)訂單類型
REFUND
buyer_idString(30)用戶標識
tidString(20)終端號,當消費請求有送的時候返回
transaction_idString(64)支付提供方單號
trade_noString(64)支付提供方單號
payment_typeString(8)錢包類型
trade_timeString交易時間,格式: yyyy-MM-dd HH:mm:ss
transaction_amountString(8)退款金額
currencyString(10)貨幣
original_amountString(8)原交易金額

{
    "service": "service.unified.RefundStatusQuery",
    "user_confirm_key": "S0000XXX",
    "out_trade_no": "60001900057884002011XXXXXX",
    "refund_no": "R6000220304056600010201XXXXXX",
    "sign": "01956c0d46d99f1b2d25277XXXXXX2177d0a781546660fd16f9fd6e41489c788",
    "time": "20220304175554",
    "querytype": "OUT_TRADE"
}

{
    "trade_status": "TRADE_REFUND",
    "refund_status": "SUCCESS",
    "trade_time": "2022-03-04 10:46:42",
    "recv_account": "支付用户零钱",
    "out_trade_no": "60001900057884002011XXXXXX",
    "eftpay_trade_no": "1852010010166666666203nnlXXXXXX",
    "eft_trade_no": "1852010010166666666203nnlXXXXXX",
    "user_confirm_key": "S0000XXX",
    "buyer_id": "oGw5c50Z359CkfEwmKlDryXXXXXX",
    "transaction_id": "4200001364202203043271XXXXXX",
    "trade_no": "4200001364202203043271XXXXXX",
    "payment_type": "WECHATCN",
    "currency": "CNY",
    "original_amount": "1.0",
    "refund_no": "R6000220304056600010201XXXXXX",
    "transaction_amount": "0.5",
    "trade_type": "REFUND",
    "time": "20220304175557",
    "return_status": "00",
    "return_char": "",
    "sign": "5d27e3ab565c745016c06c9d573XXXXXXf70518646d82c2e76b5b2d062c3c13d"
}