话费直充接口
<h5>接口描述</h5>
<ul>
<li>话费专用接口</li>
<li>接口方向：接入方 → 本平台</li>
<li>限速控制：100请求/s/IP（可联系技术调整）</li>
</ul>
<h5>请求URL</h5>
<ul>
<li>http(https)://IP:端口/api/hf/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;">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;">isp</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">yd</td>
<td>运营商(移动：yd，联通：lt，电信：dx，广电：gd)如不传则使用本系统号码库识别，不保障携号转网数据准确性，携号问题自理</td>
</tr>
<tr>
<td style="text-align: left;">provinceCode</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">1</td>
<td>归属地省份代码，取值见省份代码表（与provinceName传其中一个即可，都传则以provinceCode为准）</td>
</tr>
<tr>
<td style="text-align: left;">provinceName</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">广东</td>
<td>归属地省份名称，取值见省份代码表（与provinceCode传其中一个即可，都传则以provinceCode为准）</td>
</tr>
<tr>
<td style="text-align: left;">timeout</td>
<td style="text-align: left;">-</td>
<td style="text-align: left;">180</td>
<td>订单超时时间，单位：秒（超过该时间订单不再失败重试，如果已提交上级则需等待上级返回）</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;">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>请求结果，[结果码](<a href="https://www.showdoc.cc/900133176881927?page_id=4798461840785393">https://www.showdoc.cc/900133176881927?page_id=4798461840785393</a> "结果码")</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>