鼎音充值系统

API文档示例


订单提交接口(话费,油卡)

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>通过此接口提交话费,油卡等充值订单</li> </ul> <h5>请求URL</h5> <ul> <li><code>地址:http://平台服务地址:9086/onlinepay.do</code></li> </ul> <h5>请求方式</h5> <ul> <li>post</li> </ul> <h5>Header</h5> <table> <thead> <tr> <th>header</th> <th>示例值</th> <th>必选</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>Content-type</td> <td></td> <td>是</td> <td>string</td> <td>application/x-www-form-urlencoded</td> </tr> </tbody> </table> <h5>请求Body参数</h5> <table> <thead> <tr> <th>参数名</th> <th>示例值</th> <th>必选</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>userid</td> <td></td> <td>是</td> <td>string</td> <td>商户编号(非登录名),平台方提供</td> </tr> <tr> <td>productid</td> <td></td> <td>是</td> <td>string</td> <td>平台商品编号(向平台索取)。 全国类商品需填写商品编号,分省商品时为空字符串,为空时根据号码自动判断运营商。充流量时填写对应流量商品编号。</td> </tr> <tr> <td>price</td> <td></td> <td>是</td> <td>string</td> <td>充值金额(面值)整数,如:50,100..流量商品时候传 100M,1G 这样的字符</td> </tr> <tr> <td>num</td> <td></td> <td>是</td> <td>string</td> <td>订单商品数量(只能为1)</td> </tr> <tr> <td>mobile</td> <td></td> <td>是</td> <td>string</td> <td>充值手机号,充加油卡时是卡号</td> </tr> <tr> <td>spordertime</td> <td></td> <td>是</td> <td>string</td> <td>代理商订单时间,(yyyyMMddHHmmss)如20210224134552</td> </tr> <tr> <td>sporderid</td> <td></td> <td>是</td> <td>string</td> <td>代理商系统订单号(流水号)要求不可重复,每笔只可同时提交一次</td> </tr> <tr> <td>gascardtel</td> <td></td> <td>否</td> <td>string</td> <td>可以为空,加油卡持卡人手机号,(不参与签名 )</td> </tr> <tr> <td>gascardname</td> <td></td> <td>否</td> <td>string</td> <td>可为空,加油卡持卡人姓名,(不参与签名 )</td> </tr> <tr> <td>sign</td> <td></td> <td>是</td> <td>string</td> <td>验证摘要串(注一)</td> </tr> <tr> <td>back_url</td> <td></td> <td>否</td> <td>string</td> <td>回调URL,(不参与签名 )</td> </tr> <tr> <td>paytype</td> <td></td> <td>否</td> <td>string</td> <td>运营商类型,联通:lt 移动:yd 电信:dx。paytype和实际不符的,以用户上传的为准。加油卡不填(不参与签名 )</td> </tr> </tbody> </table> <h5>成功返回示例</h5> <pre><code>&lt;?xml version="1.0" encoding="GB2312" ?&gt; &lt;order&gt; &lt;orderid&gt;XS090428000003&lt;/orderid&gt; &lt;productid&gt;3312&lt;/productid&gt; &lt;num&gt;1&lt;/num&gt; &lt;ordercash&gt;98.5&lt;/ordercash&gt; &lt;productname&gt; 广东移动100元直充&lt;/productname&gt; &lt;sporderid&gt;2009042800001&lt;/sporderid&gt; &lt;mobile&gt;13590101510&lt;/mobile&gt; &lt;merchantsubmittime&gt;&lt;/merchantsubmittime&gt; &lt;resultno&gt;0&lt;/resultno&gt; &lt;remark1&gt;&lt;/remark1&gt; &lt;fundbalance&gt;100000&lt;/fundbalance&gt; &lt;/order&gt;</code></pre> <h5>成功返回示例的参数说明</h5> <table> <thead> <tr> <th>参数名</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>orderid</td> <td>string</td> <td>直充平台订单号</td> </tr> <tr> <td>productid</td> <td>string</td> <td>商品编号</td> </tr> <tr> <td>num</td> <td>string</td> <td>数量</td> </tr> <tr> <td>ordercash</td> <td>string</td> <td>订单金额</td> </tr> <tr> <td>productname</td> <td>string</td> <td>商品名称</td> </tr> <tr> <td>sporderid</td> <td>string</td> <td>商户平台订单号</td> </tr> <tr> <td>mobile</td> <td>string</td> <td>充值手机号</td> </tr> <tr> <td>merchantsubmittime</td> <td>string</td> <td>订单处理时间</td> </tr> <tr> <td>resultno</td> <td>string</td> <td>直充结果编码 详见备注描述</td> </tr> <tr> <td>remark1</td> <td>string</td> <td>部分错误原因描述或者为空</td> </tr> <tr> <td>fundbalance</td> <td>string</td> <td>结算后余额(不代表实时余额)</td> </tr> </tbody> </table> <h5>备注</h5> <p>(注一)验证摘要串顺序规则:<br /> sign=MD5(userid=xxxx&amp;productid=xxxxxxx&amp;price=xxxx&amp;num=xxx&amp;mobile=xxxxx&amp;spordertime=xxxxxxx&amp;sporderid=xxxxx&amp;key=xxxxxxx).toUpperCase()<br /> 参数为空的时候传空字符串,不是传null.<br /> xxxx为参数的值<br /> userid和key 都由平台提供,请联系商务获取</p>

页面列表

ITEM_HTML