Appearance
支付订单查询
公共参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例 |
---|---|---|---|---|---|
mch_no | String | 是 | 32 | 商户号 | 2014072300007148 |
method | String | 是 | 128 | 接口名称 | trade.pay.query |
charset | String | 是 | 10 | 调用的接口版本,固定为:utf-8 | utf-8 |
sign_type | String | 是 | 10 | 商户生成签名字符串所使用的签名算法类型,目前支持 RSA | RSA |
sign | String | 是 | 344 | 商户请求参数的签名串 | 详见示例 |
timestamp | String | 是 | 19 | 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" | 2014-07-24 03:07:50 |
version | String | 是 | 3 | 调用的接口版本,固定为:1.0 | 1.0 |
notify_url | String | 否 | 256 | 异步通知地址 | |
return_url | String | 否 | 256 | 同步跳转地址 | |
biz_content | String | 是 | 业务参数 |
业务参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例 |
---|---|---|---|---|---|
out_trade_no | String | 二选一 | 64 | 商户订单号。由商家自定义,需保证在商户端不重复。 | 20150320010101001 |
trade_no | String | 二选一 | 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=="
}
返回字段说明
名称 | 类型 | 描述 |
---|---|---|
code | Int | 20000 |
msg | String | success |
out_trade_no | String | 商户订单号 |
sign | String | 签名字符串 |
mch_no | String | 鸿闻商户号 |
total_amount | String | 订单总金额 |
refund_amount | String | 退款金额 |
trade_no | Int | 鸿闻订单号 |
institution_trade_no | String | 机构订单号 |
payer_id | String | openid |
trade_status | String | 状态(详见返回状态说明) |
channel_order_id | String | 渠道单号 |
bank_order_id | String | 银行单号 |
pay_time | Int | 支付成功的秒级时间戳,只有当订单状态为TRADE_SUCCESS(交易成功)、TRADE_REFUND(全额退款)、TRADE_PARTIAL_REFUND(部分退款)时有值,其余都为空字符串。 |
返回状态说明
名称 | 描述 |
---|---|
TRADE_SUCCESS | 交易成功 |
TRADE_WAIT_PAY | 待支付 |
TRADE_REFUND | 全额退款 |
TRADE_CLOSED | 交易关闭 |
TRADE_PARTIAL_REFUND | 部分退款 |