智能货柜

智能货柜


创建支付分订单

<h3>接口说明</h3> <ul> <li> <p>适用对象:直连商户</p> </li> <li> <p>请求URL:<a href="https://open.yushuokj.cn/mini/v3/payscore/createorder">https://open.yushuokj.cn/mini/v3/payscore/createorder</a></p> </li> <li>请求方式:POST</li> </ul> <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>terminal_no</td> <td>string</td> <td>是</td> <td>终端号</td> <td>70005551</td> </tr> <tr> <td>open_id</td> <td>string</td> <td>是</td> <td>用户openid</td> <td>rfdcddqqSrtyuiohhkii</td> </tr> </tbody> </table> <h3>请求示例</h3> <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>商户服务订单号</td> <td>out_order_no</td> <td>string[1,32]</td> <td>是</td> <td>调用接口提交的商户服务订单号。 示例值:1234323JKHDFE1243252</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>service_introduction</td> <td>string[1,20]</td> <td>是</td> <td>服务信息,用于介绍本订单所提供的服务。 示例值:某某酒店</td> </tr> <tr> <td>服务订单状态</td> <td>state</td> <td>string[1,32]</td> <td>是</td> <td>表示当前单据状态。枚举值: 1、CREATED:商户已创建服务订单 2、DOING:服务订单进行中 3、DONE:服务订单完成 4、REVOKED:商户取消服务订单 5、EXPIRED:服务订单已失效 示例值:CREATED</td> </tr> <tr> <td>订单状态说明</td> <td>state_description</td> <td>string (32)</td> <td>否</td> <td>对服务订单&quot;进行中&quot;状态的附加说明。 1、USER_CONFIRM:用户确认 2、MCH_COMPLETE:商户完结 示例值:MCH_COMPLETE</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字符,超出报错处理。 示例值Easdfowealsdkjfnlaksjdlfkwqoi&amp;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>package</td> <td>string[1,300]</td> <td>是</td> <td>用户跳转到微信侧小程序订单数据,需确认模式特有API中调起支付分-确认订单传入。该数据一小时内有效。 示例值:DJIOSQPYWDxsjdldeuwhdodwxasd_dDiodnwjh9we</td> </tr> </tbody> </table> <h4>返回示例</h4> <ul> <li> <p><a href="javascript:;">正常示例</a></p> <p>{ &quot;appid&quot;: &quot;wxd678efh567hg6787&quot;, &quot;mchid&quot;: &quot;1230000109&quot;, &quot;out_order_no&quot;: &quot;1234323JKHDFE1243252&quot;, &quot;service_id&quot;: &quot;500001&quot;, &quot;service_introduction&quot;: &quot;某某酒店&quot;, &quot;state&quot;: &quot;CREATED&quot;, &quot;state_description&quot;: &quot;MCH_COMPLETE&quot;, &quot;post_payments&quot;: [ { &quot;name&quot;: &quot;就餐费用服务费&quot;, &quot;amount&quot;: 4000, &quot;description&quot;: &quot;就餐人均100元服务费:100/小时&quot;, &quot;count&quot;: 1 } ], &quot;post_discounts&quot;: [ { &quot;name&quot;: &quot;满20减1元&quot;, &quot;description&quot;: &quot;不与其他优惠叠加&quot; } ], &quot;risk_fund&quot;: { &quot;name&quot;: &quot; ESTIMATE_ORDER_COST&quot;, &quot;amount&quot;: 10000, &quot;description&quot;: &quot;就餐的预估费用&quot; }, &quot;time_range&quot;: { &quot;start_time&quot;: &quot;20091225091010&quot;, &quot;end_time&quot;: &quot;20091225121010&quot; }, &quot;location&quot;: { &quot;start_location&quot;: &quot;嗨客时尚主题展餐厅&quot;, &quot;end_location&quot;: &quot;嗨客时尚主题展餐厅&quot; }, &quot;attach&quot;: &quot;Easdfowealsdkjfnlaksjdlfkwqoi&amp;wl3l2sald&quot;, &quot;notify_url&quot;: &quot;<a href="https://api.test.com&quot">https://api.test.com&quot</a>;, &quot;order_id&quot;: &quot;15646546545165651651&quot;, &quot;package&quot;: &quot; DJIOSQPYWDxsjdldeuwhdodwxasd_dDiodnwjh9we &quot; }</p> </li> </ul> <h3>错误码<a href="https://pay.weixin.qq.com/wiki/doc/apiv3/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> <p><code>微信参数文档</code> <a href="https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter6_1_14.shtml">https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter6_1_14.shtml</a></p>

页面列表

ITEM_HTML