Skip to content

支付订单查询

公共参数

参数类型是否必填最大长度描述示例
mch_noString32商户号2014072300007148
methodString128接口名称trade.pay.query
charsetString10调用的接口版本,固定为:utf-8utf-8
sign_typeString10商户生成签名字符串所使用的签名算法类型,目前支持 RSARSA
signString344商户请求参数的签名串详见示例
timestampString19发送请求的时间,格式"yyyy-MM-dd HH:mm:ss"2014-07-24 03:07:50
versionString3调用的接口版本,固定为:1.01.0
notify_urlString256异步通知地址
return_urlString256同步跳转地址
biz_contentString业务参数

业务参数

参数类型是否必填最大长度描述示例
out_trade_noString二选一64商户订单号。由商家自定义,需保证在商户端不重复。20150320010101001
trade_noString二选一64平台商订单号20150320010101001
json
 返回成功示例:
{
    "code": 20000,
    "msg": "success",
    "mch_no": "23571021153475",  // 鸿闻商户号
    "out_trade_no": "ZP5996963144147443955", // 商户订单号
    "total_amount": "46.23", // 订单总金额
    "refund_amount": "0.00", // 退款金额
    "trade_status": "TRADE_SUCCESS",
    "trade_no": 773142062014939136, // 鸿闻订单号
    "institution_trade_no": "25042211103250573860133", // 机构订单号
    "payer_id": "oJ_B26zG7qP1nsAjLRZWKpZMowR8",  // openid
    "sign_type": "RSA",
    "pay_time": 1746521004,
    "channel_order_id ": "4200002678202505068107797945", // 渠道单号
    "bank_order_id": "", // 银行单号
    "sign": "ZrRc/Y6KRDTMCZwWsauYcYfk8HB6if1gQtlZwDagv6PoLrutfuWRwHBZUno3UmILOqBM9conG2Z0SU1RgEIw2IkdFsjFmEVcQAiSJiv+kGICFVnQBzGBn9G+BaP3WC2hU1u+efqmXfZwhigWl5/2z+WE4SqlZx6I1miDTj1TAtO93MW4Nt3N5f0Oay/QlZUMhEDe0aIQv4pzcO/8iPajoQSF2tXGuIwRkoN7ytLVAskc3ttARYeCSKypNKwJbkoQYQ/ACE0uUAMEyPbqIztdW0j9DNv2MhDwwNqUa1mVH7r4udIKq9peMs83ViSwInksbuKFR0+CWEZfD1YbfspTDA=="
}

返回字段说明

名称类型描述
codeInt20000
msgStringsuccess
out_trade_noString商户订单号
signString签名字符串
mch_noString鸿闻商户号
total_amountString订单总金额
refund_amountString退款金额
trade_noInt鸿闻订单号
institution_trade_noString机构订单号
payer_idStringopenid
trade_statusString状态(详见返回状态说明)
channel_order_idString渠道单号
bank_order_idString银行单号
pay_timeInt支付成功的秒级时间戳,只有当订单状态为TRADE_SUCCESS(交易成功)、TRADE_REFUND(全额退款)、TRADE_PARTIAL_REFUND(部分退款)时有值,其余都为空字符串。

返回状态说明

名称描述
TRADE_SUCCESS交易成功
TRADE_WAIT_PAY待支付
TRADE_REFUND全额退款
TRADE_CLOSED交易关闭
TRADE_PARTIAL_REFUND部分退款