下单接口
<h5>简要描述</h5>
<ul>
<li>下单接口(游客下单后,通过该接口将订单信息推送给供应商预下单,需要等支付成功接口调用后才生效)</li>
</ul>
<h5>请求URL</h5>
<ul>
<li>请求地址: <code>/product/createOrder</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>方法名称</h5>
<ul>
<li>createOrder</li>
</ul>
<h5>请求参数</h5>
<table>
<thead>
<tr>
<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;">user_id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户ID-供应商给平台分配的账号</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">method</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">传createOrder</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">时间戳</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">签名</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">orderId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">平台订单号</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">travelDate</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">游玩日期(yyyy-MM-dd)</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">bookName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">预订人姓名</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">bookMobile</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">预订人手机号</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">idCard</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">预订人身份证号</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">products</td>
<td style="text-align: left;">object[](对象数组)</td>
<td style="text-align: left;">产品信息</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;"><strong>products中的单个对象数据结构</strong></td>
<td style="text-align: left;">&emsp;</td>
<td style="text-align: left;">&emsp;</td>
<td>&emsp;</td>
</tr>
<tr>
<td style="text-align: left;">productId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">产品ID</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">quantity</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">预订数量</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">visitPersons</td>
<td style="text-align: left;">object[](对象数组)</td>
<td style="text-align: left;">游玩人信息</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;"><strong>visitPersons中的单个对象数据结构</strong></td>
<td style="text-align: left;">&emsp;</td>
<td style="text-align: left;">&emsp;</td>
<td>&emsp;</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">游玩人姓名</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">mobile</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">游玩人手机号</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">idCard</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">身份证号</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">face</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">人像图片(转换为base64编码传递)</td>
<td>否</td>
</tr>
</tbody>
</table>
<h5>返回参数</h5>
<table>
<thead>
<tr>
<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;">res_code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">返回的状态</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">res_msg</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">返回信息</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">时间戳</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">orderId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">平台订单号</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">partnerOrderId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">供应商订单号</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">orderAmount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单金额</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">visitPersons</td>
<td style="text-align: left;">object[](对象数组)</td>
<td style="text-align: left;">游玩人信息</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;"><strong>visitPersons中的单个对象数据结构</strong></td>
<td style="text-align: left;">&emsp;</td>
<td style="text-align: left;">&emsp;</td>
<td>&emsp;</td>
</tr>
<tr>
<td style="text-align: left;">productId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">产品ID</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">ticketId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">门票号(可用于查询、退票、核销二维码)</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">idCard</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">身份证号</td>
<td>是</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>原始请求数据:
{
&quot;user_id&quot;: &quot;1d9a42e0-9de3-451b-9964-4e9f8e62b908&quot;,
&quot;method&quot;: &quot;createOrder&quot;,
&quot;timestamp&quot;: 1597798617151,
&quot;sign&quot;: &quot;2b56681e732e4e0e5f27ac366bd2b5ff&quot;,
&quot;orderId&quot;: &quot;621600&quot;,
&quot;travelDate&quot;: &quot;2020-08-21&quot;,
&quot;bookName&quot;: &quot;李东&quot;,
&quot;bookMobile&quot;: &quot;17720761547&quot;,
&quot;idCard&quot;: &quot;530121198204177172&quot;,
&quot;products&quot;: [{
&quot;productId&quot;: &quot;78555140&quot;,
&quot;quantity&quot;: 1,
&quot;visitPersons&quot;: [{
&quot;name&quot;: &quot;李东&quot;,
&quot;mobile&quot;: &quot;17720761547&quot;,
&quot;idCard&quot;: &quot;530121198204177172&quot;,
&quot;face&quot;: &quot;&quot;
}]
}]
}</code></pre>
<h5>响应示例</h5>
<pre><code>原始响应数据:
{
&quot;res_code&quot;: &quot;1000&quot;,
&quot;res_msg&quot;: &quot;操作成功&quot;,
&quot;timestamp&quot;: 1597990905,
&quot;orderId&quot;: &quot;621600&quot;,
&quot;partnerOrderId&quot;: &quot;ZA2020063017130001509PM&quot;,
&quot;orderAmount&quot;: &quot;500.00&quot;,
&quot;visitPersons&quot;: [{
&quot;productId&quot;: &quot;219446050484649984&quot;
&quot;ticketId&quot;: &quot;11444587&quot;,
&quot;idCard&quot;: &quot;530121198204177172&quot;
}]
}
</code></pre>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>