订单提交
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>订单提交接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://xx.com/api/v1/merchant/submit</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET </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;">merchantAppId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户应用ID，例：123456</td>
</tr>
<tr>
<td style="text-align: left;">merchantOrderId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户订单号，<em>a-zA-Z0-9_-{3,40}</em></td>
</tr>
<tr>
<td style="text-align: left;">mobile</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>充值号码</td>
</tr>
<tr>
<td style="text-align: left;">priceType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>产品类型，1=话费快充</td>
</tr>
<tr>
<td style="text-align: left;">sp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>运营商代码，1移动/2联通/3电信</td>
</tr>
<tr>
<td style="text-align: left;">province</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>省份代码</td>
</tr>
<tr>
<td style="text-align: left;">faceAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>面值</td>
</tr>
<tr>
<td style="text-align: left;">facePrice</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>价格，单位：厘，用于校验价格差异</td>
</tr>
<tr>
<td style="text-align: left;">callbackUrl</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>订单回调地址</td>
</tr>
<tr>
<td style="text-align: left;">attach</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">json</td>
<td>商户附加信息，json 格式，回调原样返回</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>UNIX 时间戳（秒）</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名，32位小写MD5签名</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<p>成功，code=1000</p>
<pre><code class="language-json">{
&quot;code&quot;: 1000,
&quot;message&quot;: &quot;OK&quot;,
&quot;data&quot;: {
&quot;orderNo&quot;: 1234567890,
&quot;orderStatus&quot;: 1,
&quot;orderContent&quot;: &quot;北京移动100元快充&quot;,
&quot;price&quot;: 99.8,
&quot;mobile&quot;: &quot;13800000000&quot;,
&quot;merchantAppId&quot;: &quot;20660010001&quot;,
&quot;merchantOrderId&quot;: &quot;123456&quot;,
&quot;desc&quot;: &quot;充值中&quot;
}
}</code></pre>
<p>失败</p>
<pre><code class="language-json">{
&quot;code&quot;: 2001,
&quot;message&quot;: &quot;用户不存在&quot;,
&quot;data&quot;: null
}</code></pre>
<h5>data 参数内容说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">orderNo</td>
<td style="text-align: left;">int</td>
<td>平台订单号</td>
</tr>
<tr>
<td style="text-align: left;">orderStatus</td>
<td style="text-align: left;">int</td>
<td>订单状态码，1充值中/2成功/3失败</td>
</tr>
<tr>
<td style="text-align: left;">orderContent</td>
<td style="text-align: left;">string</td>
<td>订单内容</td>
</tr>
<tr>
<td style="text-align: left;">price</td>
<td style="text-align: left;">decimal</td>
<td>订单价格</td>
</tr>
<tr>
<td style="text-align: left;">desc</td>
<td style="text-align: left;">string</td>
<td>订单状态描述</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>code为 1000 时表示下单成功，其他返回码详见附录-code 返回码。</li>
</ul>