通用直充接口
<h5>接口描述</h5>
<ul>
<li>接口方向：接入方 → 本平台</li>
<li>限速控制：100请求/s/IP（可联系技术调整）</li>
<li>适用于直充形式的虚拟充值、生活缴费等业务</li>
</ul>
<h5>请求URL</h5>
<ul>
<li>http(https)://IP:端口/api/order/submit</li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST（application/x-www-form-urlencoded）</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;">appId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">4Kq9U9rVFz</td>
<td>应用ID</td>
</tr>
<tr>
<td style="text-align: left;">outOrderId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">cy1017010101010101</td>
<td>接入方订单ID，长度<=50，[幂等性说明](<a href="https://www.showdoc.com.cn/2167197494741781/9729869062769459">https://www.showdoc.com.cn/2167197494741781/9729869062769459</a> "幂等性说明")</td>
</tr>
<tr>
<td style="text-align: left;">uuid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">18898811111</td>
<td>充值号码/帐号/卡号</td>
</tr>
<tr>
<td style="text-align: left;">itemId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">100001</td>
<td>商品ID</td>
</tr>
<tr>
<td style="text-align: left;">itemFace</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">10</td>
<td>商品面值（单位：元）用于校验避免配置失误造成损失，为空则不检验</td>
</tr>
<tr>
<td style="text-align: left;">itemPrice</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">5.122</td>
<td>结算单价（单位：元，精确到小数点后3位，不需要末尾补0）用于校验避免配置失误造成损失，为空则不检验</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">1</td>
<td>充值数量，默认值：1，对应商品是否支持单次充值多个请咨询商务</td>
</tr>
<tr>
<td style="text-align: left;">callbackUrl</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;"><a href="http://www.xx.cn/receipt">http://www.xx.cn/receipt</a></td>
<td>订单状态回调地址，为空则不回调</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">20160311154602111</td>
<td>时间戳,格式:yyyyMMddHHmmssSSS</td>
</tr>
<tr>
<td style="text-align: left;">smsCode</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">121212</td>
<td>短信验证码，部分商品需要</td>
</tr>
<tr>
<td style="text-align: left;">ext1</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">-</td>
<td>扩展参数1（Q币/游戏：终端ip、中石化：手机号、电费：(如：广东，如还需传市，如：湖北&#124;武汉)</td>
</tr>
<tr>
<td style="text-align: left;">ext2</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">-</td>
<td>扩展参数2 （游戏：区、中石化/电费：身份证号后6位）</td>
</tr>
<tr>
<td style="text-align: left;">ext3</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">-</td>
<td>扩展参数3 （游戏：服、中石化：姓名，电费：1-住宅，2-店铺，3-企业）</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">tmE36C00Hzbj1TF2</td>
<td>签名，[签名算法](<a href="https://www.showdoc.cc/900133176881927?page_id=4798471163226341">https://www.showdoc.cc/900133176881927?page_id=4798471163226341</a> "签名算法")</td>
</tr>
</tbody>
</table>
<h4><em>注意：</em></h4>
<ul>
<li>如不能保证每次调用下单接口时outOrderId的历史唯一性，请阅读“幂等性说明”章节。</li>
</ul>
<h4>返回格式：json</h4>
<h4>返回参数</h4>
<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;">code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">00</td>
<td>请求结果，请看结果码章节</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">下单成功</td>
<td>结果详细描述，建议保存，方便排障</td>
</tr>
<tr>
<td style="text-align: left;">orderId</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">201701010101010001</td>
<td>平台订单号</td>
</tr>
<tr>
<td style="text-align: left;">outOrderId</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">cy1017010101010101</td>
<td>接入方订单号</td>
</tr>
<tr>
<td style="text-align: left;">cost</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">10.355</td>
<td>本次总消费，单位(元)</td>
</tr>
</tbody>
</table>
<h4><em>注意：</em></h4>
<p>code为00时表示下单成功，code为-16、-99、接口调用超时<strong>存疑处理</strong>(调用查单接口查询或与客服确认)。</p>
<h5>返回示例</h5>
<pre><code> {
&quot;code&quot;:&quot;00&quot;,
&quot;msg&quot;:&quot;下单成功&quot;,
&quot;orderId&quot;:&quot;201701010101010001&quot;,
&quot;outOrderId&quot;:&quot;cy1017010101010101&quot;,
&quot;cost&quot;:&quot;10.335&quot;
}</code></pre>