Skip to main content

Refund Account Inquiry


You can inquire about the information of the refund to the account.

Currently only supports WeChat and Alipay. Alipay needs to apply for permission.

Info

{domain}/Servlet/JSAPIService.do

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

NameTypeDescriptionRequirement
serviceStringInterface name
service.unified.RefundStatusQuery
querytypeString(30)Query type, fixed: OUT_TRADE
eft_trade_noString(28)eftPay order number
eft_trade_no and out_trade_no choose one
out_trade_noString(28)Merchant order number
out_trade_no and eft_trade_no choose one
refund_noString(28)Merchant refund number
user_confirm_keyString(12)User Key, provided by eftPay
timeStringTime, format: yyyyMMddHHmmss
signString(64)Signature

Tips

  • Priority eft_trade_no > out_trade_no

NameTypeDescriptionRequirement
return_statusString(3)Return status code, represents . Note: This parameter cannot be used to judge whether the transaction status is successful
Other status codes see Appendix 3
return_charString(100)Return description, may change, cannot be conditional judgment
return_status greater than 00 returns
timeStringTime, format: yyyyMMddHHmmss
return_status >= 00 returns
signString(64)Signature
return_status >= 00 returns

NameTypeDescriptionRequirement
out_trade_noString(28)Merchant order number
refund_noString(28)Merchant refund number
eft_trade_noString(28)eftPay order number
eftpay_trade_noString(28)eftPay order number
trade_statusString(32)Trade status, see Appendix 2
refund_statusString(32)Refund status
SUCCESS - Successful
PROCESSING - Processing
FAIL - Failed
recv_accountString(64)Refund recipient, only supported by WeChat, other transactions return empty string
user_confirm_keyStringUser Key, provided by eftPay
trade_typeString(10)Order type
REFUND
buyer_idString(30)User ID
tidString(20)Terminal number, returned when the consumption request is sent
transaction_idString(64)Payment provider's order number
trade_noString(64)Payment provider's order number
payment_typeString(8)Wallet type
trade_timeStringTrade time, format: yyyy-MM-dd HH:mm:ss
transaction_amountString(8)Refund amount
currencyString(10)Currency
original_amountString(8)Original transaction amount

{
    "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"
}