Skip to main content

Query


You can query information about consumption transactions and refund transactions.

Info

{domain}/Servlet/QRcodeTradeQuery.do

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

NameTypeDescriptionRequired
querytypeString(30)Query type, fixed: OUT_TRADE
out_trade_noString(28)Merchant order number
refund_noString(28)Merchant refund number, used for refund query
user_confirm_keyString(12)User Key provided by eftPay
paytypeString(6)Payment type
payment_typeString(20)Wallet type
timeStringTime, format: yyyyMMddHHmmss
signString(64)Signature

Tips

When refund_no is not filled or is "", it returns order information based on out_trade_no, i.e., the trade_status is the status of the consumption order. Otherwise, it returns refund information based on refund_no, i.e., the trade_status is the status of the refund order.

NameTypeDescriptionRequirement
return_statusString(3)Return status code, "00" represents success. Note: This parameter cannot be used to determine the success of the transaction.
Other status codes see Appendix 3
Required
return_charString(100)Return description, it may change and cannot be used as a condition for judgmentRequired
When return_status is greater than 00
timeStringTime, format: yyyyMMddHHmmss
Returned when return_status >= 00
Optional
signString(64)Signature
Returned when return_status >= 00
Optional

NameTypeDescriptionRequirement
out_trade_noString(28)Merchant order numberRequired
extra_trade_noString(28)Merchant refund number, returned when querying refundOptional
eftpay_trade_noString(28)Eftpay order numberRequired
trade_statusString(32)Transaction status, see Appendix 2Required
user_confirm_keyString(12)User Key provided by eftPayRequired
trade_typeString(10)Order type, see Appendix 4Required
buyer_idString(30)User identifierRequired
tidString(20)Terminal number, returned when there is a delivery in the requestOptional
transaction_idString(64)Payment provider numberRequired
payment_typeString(8)Wallet typeRequired
trade_timeStringTransaction time, format: yyyy-MM-dd HH:mm:ssRequired

{
    "user_confirm_key": "12345678",
    "out_trade_no": "201908241040035",
    "sign": "24db1adc94b18a416796695a3062398bf3908bff7647da4948b769bf118dff87",
    "time": "20190824104052",
    "paytype": "WeChat",
    "payment_type": "WECHATCN",
    "querytype": "OUT_TRADE"
}

{
    "return_status": "00",
    "return_char": "",
    "sign": "6077b275107676aac219cb38d7970a8f3de607f47d6baa6320f337a4ca1358e2",
    "time": "20190824104135",
    "out_trade_no": "201908241040035",
    "eftpay_trade_no": "08520005269190824104101935",
    "trade_status": "TRADE_SUCCESS",
    "user_confirm_key": "12345678",
    "trade_type": "SALE",
    "buyer_id": "2088012867786450",
    "tid": "tid123",
    "transaction_id": "2019082422001486450540740143",
    "payment_type": "WECHATCN",
    "trade_time": "2019-08-24 10:41:25",
    "transaction_amount": "0.02",
    "currency": "HKD",
    "original_amount": "10.01",
    "rate": ""
}