查询

可以查询消费交易和退款交易的信息。

请求地址

相关信息

{domain}/Servlet/QRcodeTradeQuery.do POST

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

请求参数

名称	类型	描述	要求
querytype	String(30)	查询类型，固定：OUT_TRADE	Required
out_trade_no	String(28)	商户订单号	Required
refund_no	String(28)	商户退款号，查询退款交易时传入	Optional
user_confirm_key	String(12)	用户Key，由 eftPay 提供	Required
paytype	String(6)	支付类型	Required
payment_type	String(20)	钱包类型	Required
time	String	时间，格式：yyyyMMddHHmmss	Required
sign	String(64)	签名	Required

提示

当 refund_no 不填或者为""时，返回基于 out_trade_no 的订单信息，即 trade_status 为订单消费订单的状态；否则返回基于 refund_no 的退款信息，即 trade_status 为退款订单的状态。

公共返回参数

名称	类型	描述	要求
return_status	String(3)	返回状态码，"00"代表成功。注：此参数不可作为交易状态是否成功的判断 其他状态码见 附录3	Required
return_char	String(100)	返回说明，可能会变化，不能作条件判断	Required
return_status 大于 00 时返回
time	String	时间，格式：yyyyMMddHHmmss return_status >= 00 时返回	Optional
sign	String(64)	签名 return_status >= 00 时返回	Optional

以下参数 成功 时返回

名称	类型	描述	要求
out_trade_no	String(28)	商户订单号	Required
extra_trade_no	String(28)	商户退款号，查询退款返回	Optional
eftpay_trade_no	String(28)	依付得订单号	Required
trade_status	String(32)	交易状态，见 附录2	Required
user_confirm_key	String(12)	用户Key，由 eftPay 提供	Required
trade_type	String(10)	订单类型，见 附录4	Required
buyer_id	String(30)	用户标识	Required
tid	String(20)	终端号，当消费请求有送的时候返回	Optional
transaction_id	String(64)	支付提供方单号	Required
payment_type	String(8)	钱包类型	Required
trade_time	String	交易时间，格式：yyyy-MM-dd HH:mm:ss	Required
transaction_amount	String(8)	交易金额。 查询消费时为消费金额；查询退款时为退款金额	Required
currency	String(10)	货币	Required
original_amount	String(8)	原交易金额，查询退款返回	Optional
rate	String(10)	交易汇率，配置返回	Optional

请求示例

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