查询支付分订单
<h2>接口说明</h2>
<ul>
<li>
<p>适用对象:直连商户</p>
</li>
<li>
<p>请求URL:<a href="https://open.yushuokj.cn/mini/v3/payscore/queryorder">https://open.yushuokj.cn/mini/v3/payscore/queryorder</a></p>
</li>
<li>请求方式:GET</li>
</ul>
<p>前置条件:商户下单已受理后</p>
<p><code>path</code> 指该参数为路径参数</p>
<p><code>query</code> 指该参数需在请求URL传参</p>
<p><code>body</code> 指该参数需在请求JSON传参</p>
<p><strong>请求头部:</strong></p>
<table>
<thead>
<tr>
<th>标签</th>
<th>必填</th>
<th>内容</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Type</td>
<td>是</td>
<td>application/x-www-form-urlencoded</td>
</tr>
</tbody>
</table>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>必填</th>
<th>说明</th>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>out_order_no</td>
<td>string</td>
<td>是</td>
<td>商户服务订单号</td>
<td>srfdcddqqSrtyuiohhkii</td>
</tr>
</tbody>
</table>
<h4>请求示例</h4>
<ul>
<li>
<p><a href="javascript:;">URL</a></p>
<p><a href="https://open.yushuokj.cn/mini/v3/payscore/queryorder?out_order_no=2000008416518464133">https://open.yushuokj.cn/mini/v3/payscore/queryorder?out_order_no=2000008416518464133</a></p>
</li>
</ul>
<h3>返回参数</h3>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">必含</th>
<th style="text-align: left;">说明</th>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">响应码:200 成功,500 失败</td>
<td>200</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">响应内容,JSON等数据</td>
<td>1234</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">消息提未</td>
<td>操作成功</td>
</tr>
</tbody>
</table>
<p><strong>返data参数说明:</strong> </p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>变量</th>
<th>类型[长度限制]</th>
<th>必填</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>应用ID</td>
<td>appid</td>
<td>string[1,32]</td>
<td>是</td>
<td>调用接口提交的公众账号ID 示例值:wxd678efh567hg6787</td>
</tr>
<tr>
<td>商户号</td>
<td>mchid</td>
<td>string[1,32]</td>
<td>是</td>
<td>调用接口提交的商户号 示例值:1230000109</td>
</tr>
<tr>
<td>服务ID</td>
<td>service_id</td>
<td>string[1,32]</td>
<td>是</td>
<td>调用该接口提交的服务ID 示例值:500001</td>
</tr>
<tr>
<td>商户服务订单号</td>
<td>out_order_no</td>
<td>string[1,32]</td>
<td>是</td>
<td>调用接口提交的商户服务订单号 示例值:1234323JKHDFE1243252</td>
</tr>
<tr>
<td>服务信息</td>
<td>service_introduction</td>
<td>string[1,20]</td>
<td>是</td>
<td>服务信息用于介绍本订单所提供的服务,当参数长度超过20个字符时,报错处理。 示例值:某某酒店</td>
</tr>
<tr>
<td>服务订单状态</td>
<td>state</td>
<td>string[1,32]</td>
<td>是</td>
<td>表示当前单据状态 枚举值: CREATED:商户已创建服务订单; DOING:服务订单进行中; DONE:服务订单完成; REVOKED:商户取消服务订单; EXPIRED:服务订单已失效,"商户已创建服务订单"状态超过30天未变动,则订单失效 示例值:CREATED</td>
</tr>
<tr>
<td>订单状态说明</td>
<td>state_description</td>
<td>string[1,32]</td>
<td>否</td>
<td>对服务订单"进行中"状态的附加说明: USER_CONFIRM:用户确认 MCH_COMPLETE:商户完结 示例值:MCH_COMPLETE</td>
</tr>
<tr>
<td>商户收款总金额</td>
<td>total_amount</td>
<td>int64</td>
<td>否</td>
<td>总金额,大于等于0的数字,单位为分,只能为整数,详见<a href="https://pay.weixin.qq.com/wiki/doc/api/micropay.php?chapter=4_2">支付金额</a>。 此参数需满足:总金额=后付费项目金额之和-后付费商户优惠项目金额之和,且小于等于订单风险金额。取消订单时,该字段必须为0。 示例值:40000</td>
</tr>
<tr>
<td>+后付费项目</td>
<td>post_payments</td>
<td>array</td>
<td>否</td>
<td>后付费项目列表,最多包含100条付费项目</td>
</tr>
<tr>
<td>+后付费商户优惠</td>
<td>post_discounts</td>
<td>array</td>
<td>否</td>
<td>后付费商户优惠,最多包含30条付费项目</td>
</tr>
<tr>
<td>+订单风险金</td>
<td>risk_fund</td>
<td>object</td>
<td>否</td>
<td>订单风险金信息</td>
</tr>
<tr>
<td>+服务时间段</td>
<td>time_range</td>
<td>object</td>
<td>否</td>
<td>服务时间范围</td>
</tr>
<tr>
<td>+服务位置</td>
<td>location</td>
<td>object</td>
<td>否</td>
<td>服务使用信息</td>
</tr>
<tr>
<td>商户数据包</td>
<td>attach</td>
<td>string[1,256]</td>
<td>否</td>
<td>商户数据包可存放本订单所需信息,需要先urlencode后传入。 当商户数据包总长度超出256字符时,报错处理。商户接收回包是根据场景,决定是否需要做安全过滤(XSS/CSRF)。 示例值:Easdfowealsdkjfnlaksjdlfkwqoi&wl3l2sald</td>
</tr>
<tr>
<td>商户回调地址</td>
<td>notify_url</td>
<td>string[1,255]</td>
<td>是</td>
<td>商户接收用户确认订单和扣款成功回调通知的地址 示例值:<a href="https://api.test.com">https://api.test.com</a></td>
</tr>
<tr>
<td>微信支付服务订单号</td>
<td>order_id</td>
<td>string[1,64]</td>
<td>是</td>
<td>微信支付服务订单号,每个微信支付服务订单号与商户号下对应的商户服务订单号一一对应 示例值:15646546545165651651</td>
</tr>
<tr>
<td>是否需要收款</td>
<td>need_collection</td>
<td>bool</td>
<td>条件选填</td>
<td>是否需要收款,非0元完结后返回 true:微信支付分代收款 false:无需微信支付分代收款 示例值:true</td>
</tr>
<tr>
<td>+收款信息</td>
<td>collection</td>
<td>object</td>
<td>条件选填</td>
<td>收款信息,非0元完结后返回</td>
</tr>
<tr>
<td>用户标识</td>
<td>openid</td>
<td>string[1,128]</td>
<td>否</td>
<td>微信用户在商户对应appid下的唯一标识 示例值:oUpF8uMuAJO_M2pxb1Q9zNjWeS6o</td>
</tr>
</tbody>
</table>
<h4>返回示例</h4>
<ul>
<li>
<p><a href="javascript:;">正常示例</a></p>
<p>{
"appid": "wxd678efh567hg6787",
"mchid": "1230000109",
"service_id": "500001",
"out_order_no": "1234323JKHDFE1243252",
"service_introduction": "某某酒店",
"state": "DOING",
"state_description": "MCH_COMPLETE",
"total_amount": 3900,
"post_payments": [
{
"name": "就餐费用服务费",
"amount": 4000,
"description": "就餐人均100元服务费:100/小时",
"count": 1
}
],
"post_discounts": [
{
"name": "满20减1元",
"description": "不与其他优惠叠加",
"amount": 100
}
],
"risk_fund": {
"name": "ESTIMATE_ORDER_COST",
"amount": 10000,
"description": "就餐的预估费用"
},
"time_range": {
"start_time": "20091225091010",
"end_time": "20091225121010"
},
"location": {
"start_location": "嗨客时尚主题展餐厅",
"end_location": "嗨客时尚主题展餐厅"
},
"attach": "Easdfowealsdkjfnlaksjdlfkwqoi&wl3l2sald",
"notify_url": "<a href="https://api.test.com"">https://api.test.com"</a>;,
"order_id": "15646546545165651651",
"need_collection": true,
"collection": {
"state": "USER_PAID",
"total_amount": 3900,
"paying_amount": 3000,
"paid_amount": 900,
"details": [
{
"seq": 1,
"amount": 900,
"paid_type": "NEWTON",
"paid_time": "20091225091210",
"transaction_id": "15646546545165651651"
}
]
}
}</p>
</li>
</ul>
<h3>错误码<a href="https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/Share/error_code.shtml">公共错误码</a></h3>
<table>
<thead>
<tr>
<th>状态码</th>
<th>错误码</th>
<th>描述</th>
<th>解决方案</th>
</tr>
</thead>
<tbody>
<tr>
<td>500</td>
<td>SYSTEM_ERROR</td>
<td>系统错误</td>
<td>5开头的状态码都为系统问题,请使用相同参数稍后重新调用</td>
</tr>
<tr>
<td>400</td>
<td>PARAM_ERROR</td>
<td>参数错误</td>
<td>根据错误提示,传入正确参数</td>
</tr>
<tr>
<td>403</td>
<td>NO_AUTH</td>
<td>商户信息不合法</td>
<td>登录商户平台核对,传入正确信息</td>
</tr>
<tr>
<td>429</td>
<td>FREQUENCY_LIMITED</td>
<td>频率超限</td>
<td>请求量不要超过接口调用频率限制</td>
</tr>
<tr>
<td>400</td>
<td>INVALID_REQUEST</td>
<td>请求参数符合参数格式,但不符合业务规则</td>
<td>请确认相同单号是否使用了不同的参数</td>
</tr>
<tr>
<td>404</td>
<td>ORDER_NOT_EXIST</td>
<td>订单不存在</td>
<td>确认入参,传入正确单据</td>
</tr>
<tr>
<td>400</td>
<td>INVALID_ORDER_STATE</td>
<td>单据状态错误</td>
<td>确认操作是否符合流程</td>
</tr>
<tr>
<td>400</td>
<td>ORDER_CANCELED</td>
<td>单据已取消</td>
<td>当前状态无需操作</td>
</tr>
<tr>
<td>400</td>
<td>ORDER_DONE</td>
<td>订单已完成</td>
<td>当前状态无需操作</td>
</tr>
</tbody>
</table>