海心下游对接接口文档


话费充值下单接口

<h5>简要描述</h5> <ul> <li>充值下单操作为异步请求,报文返回成功,则表示受理成功,具体充值是否成功,则需要我方发起异步通知,或者下游发起查询请求来判断</li> </ul> <h5>请求URL</h5> <ul> <li><code>http://ip:port/order/submit</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> <li>application/json;charset=UTF-8 </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;">productId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Long</td> <td>平台商品id</td> </tr> <tr> <td style="text-align: left;">requestId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>流水Id,下游生成,不可重复</td> </tr> <tr> <td style="text-align: left;">number</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>充值号码</td> </tr> <tr> <td style="text-align: left;">checkPrice</td> <td style="text-align: left;">否</td> <td style="text-align: left;">BigDecimal</td> <td>校验价格,单位元,保留四位小数。我方平台提供该商品的代理价格(售价 x 折扣) 。&lt;font color=LightCoral &gt;校验价格与面额必传其一 &lt;/font&gt;</td> </tr> <tr> <td style="text-align: left;">faceValue</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Integer</td> <td>面额,单位元。&lt;font color=LightCoral &gt;校验价格与面额必传其一 &lt;/font&gt;</td> </tr> <tr> <td style="text-align: left;">timeOut</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Integer</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>回调地址(不需要url编码)</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String</td> <td>签名,MD5(userId+key+productId+ requestId + number)</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code>{     &amp;quot;number&amp;quot;:&amp;quot;13966666666&amp;quot;,     &amp;quot;productId&amp;quot;:10015,     &amp;quot;requestId&amp;quot;:&amp;quot;6607378090040&amp;quot;,     &amp;quot;checkPrice&amp;quot;:&amp;quot;10.0900&amp;quot;,     &amp;quot;callbackUrl&amp;quot;:&amp;quot;http://127.0.0.1:8080/callback&amp;quot;,     &amp;quot;sign&amp;quot;:&amp;quot;6848b1f4a28a67aa203ae1038113ec90&amp;quot; }</code></pre> <h5>返回参数说明</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;">code</td> <td style="text-align: left;">Integer</td> <td>返回结果码</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">String</td> <td>返回结果信息</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">Map</td> <td>数据集合,提单成功返回</td> </tr> <tr> <td style="text-align: left;">data. orderId</td> <td style="text-align: left;">Long</td> <td>我方平台订单id,提单成功返回</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code> {     &amp;quot;code&amp;quot;:200,     &amp;quot;msg&amp;quot;:&amp;quot;订单提交成功&amp;quot;,     &amp;quot;data&amp;quot;:{         &amp;quot;orderId&amp;quot;:&amp;quot;1407727321389207552&amp;quot;     } }</code></pre> <pre><code> {     &amp;quot;code&amp;quot;:413,     &amp;quot;msg&amp;quot;:&amp;quot;订单号重复&amp;quot; } </code></pre> <ul> <li>错误码</li> </ul> <table> <thead> <tr> <th style="text-align: left;">错误码</th> <th style="text-align: left;">结果</th> <th style="text-align: left;">注释</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">200</td> <td style="text-align: left;">受理成功</td> <td style="text-align: left;">&lt;font color=LightCoral &gt;受理成功,不代理充值成功。充值结果以平台回调结果或通过订单查询接口结果为准&lt;/font&gt;</td> </tr> <tr> <td style="text-align: left;">400</td> <td style="text-align: left;">失败</td> <td style="text-align: left;">参数有误(失败)</td> </tr> <tr> <td style="text-align: left;">410</td> <td style="text-align: left;">失败</td> <td style="text-align: left;">用户不存在(检查请求头是否传了Authorization-User并且是否正确) (失败)</td> </tr> <tr> <td style="text-align: left;">412</td> <td style="text-align: left;">失败</td> <td style="text-align: left;">白名单校验失败(失败)</td> </tr> <tr> <td style="text-align: left;">413</td> <td style="text-align: left;">人工确认</td> <td style="text-align: left;">&lt;font color=LightCoral &gt;流水号重复(每次请求都要求唯一) (人工确认,如果确实重复提交了,重复的订单也可以当失败处理) &lt;/font&gt;</td> </tr> <tr> <td style="text-align: left;">414</td> <td style="text-align: left;">失败</td> <td style="text-align: left;">产品不存在(失败)</td> </tr> <tr> <td style="text-align: left;">415</td> <td style="text-align: left;">失败</td> <td style="text-align: left;">用户没有配置该产品(请联系平台工作人员进行配置) (失败)</td> </tr> <tr> <td style="text-align: left;">416</td> <td style="text-align: left;">失败</td> <td style="text-align: left;">校验价格校验失败,输入价格与实际代理价格不一致(失败)</td> </tr> <tr> <td style="text-align: left;">417</td> <td style="text-align: left;">失败</td> <td style="text-align: left;">账户余额不足(失败)</td> </tr> <tr> <td style="text-align: left;">418</td> <td style="text-align: left;">失败</td> <td style="text-align: left;">用户没有配置供货商通道(请联系平台工作人员进行配置) (失败)</td> </tr> <tr> <td style="text-align: left;">419</td> <td style="text-align: left;">失败</td> <td style="text-align: left;">供货商没有配置产品信息(请联系平台工作人员进行配置) (失败)</td> </tr> <tr> <td style="text-align: left;">422</td> <td style="text-align: left;">失败</td> <td style="text-align: left;">验签失败(请检查加签参数与顺序是否正确) (失败)</td> </tr> <tr> <td style="text-align: left;">423</td> <td style="text-align: left;">失败</td> <td style="text-align: left;">充值失败,流控不通过</td> </tr> <tr> <td style="text-align: left;">500</td> <td style="text-align: left;">人工或者调查单接口确认</td> <td style="text-align: left;">&lt;font color=LightCoral &gt;服务异常(请检查请求方式,参数格式,类型是否正确) (请求格式没问题需人工确认,或者调订单查询接口查看结果,不可当失败处理)&lt;/font&gt;</td> </tr> <tr> <td style="text-align: left;">505</td> <td style="text-align: left;">失败</td> <td style="text-align: left;">充值失败</td> </tr> </tbody> </table> <ul> <li>备注:如提单过程有异常,我方没返回明确的失败时不行自行处理失败,否则自行承担后果。比如提单read timeOut,http的状态不是200等。建议通过查单接口核对。</li> </ul>

页面列表

ITEM_HTML