盟云权益对接

API文档


提交订单接口

<h4><strong>简要描述:</strong></h4> <p>提交订单接口 1.POST请求,Content-Type必须设置为:application/json; 2.接口是异步,接口调用成功(即下单成功),不代表充值成功 3.最终“充值结果”,需要调用“订单详情接口”进行查询,由于取卡是异步操作,建议间隔1-3s循环调用,直至最终结果; 4.此接口不会返回卡密数据,需要再调用“订单详情接口”获取卡密信息; 5.“订单详情接口”必须接入; 6.下单接口如果请求超时,请调用订单详情接口确认下单结果;</p> <h4><strong>请求URL:</strong></h4> <p>http(s)://平台域名/api/v1/order/buy</p> <h4><strong>请求方式:</strong></h4> <p>POST</p> <h4><strong>请求参数:</strong></h4> <table> <thead> <tr> <th>Header 参数</th> <th>类型</th> <th>是否必填</th> <th>描述</th> <th>示例值</th> </tr> </thead> <tbody> <tr> <td>Sign</td> <td>string</td> <td>是</td> <td>签名</td> <td>[点击查看签名规范](<a href="https://www.showdoc.com.cn/mywlkj/11558607938542754">https://www.showdoc.com.cn/mywlkj/11558607938542754</a> &quot;点击查看签名规范&quot;)</td> </tr> <tr> <td>Timestamp</td> <td>string</td> <td>是</td> <td>13位时间戳(毫秒)</td> <td>1696644296195</td> </tr> <tr> <td>UserId</td> <td>string</td> <td>是</td> <td>您的用户接口appid</td> <td>2uIkTrXNdAFc7OKhbRenzjDtgPoZ6s5C</td> </tr> </tbody> </table> <table> <thead> <tr> <th>Body 参数</th> <th>类型</th> <th>是否必填</th> <th>描述</th> <th>示例值</th> </tr> </thead> <tbody> <tr> <td>id</td> <td>int</td> <td>是</td> <td>商品ID</td> <td>1</td> </tr> <tr> <td>url</td> <td>string</td> <td>否</td> <td>订单回调地址(没有就不传)</td> <td><a href="http://sc.ka180.cn/notify">http://sc.ka180.cn/notify</a></td> </tr> <tr> <td>external_orderno</td> <td>string</td> <td>是</td> <td>三方订单号(防重复)可传空,建议传值,需传唯一值</td> <td>D091952644768932429824</td> </tr> <tr> <td>safe_price</td> <td>string</td> <td>否</td> <td>安全价格(防止调价导致亏本,传入此参数用于对比)</td> <td>2.2</td> </tr> <tr> <td>mark</td> <td>string</td> <td>否</td> <td>下单备注</td> <td></td> </tr> <tr> <td>quantity</td> <td>int</td> <td>是</td> <td>下单数量</td> <td>1</td> </tr> <tr> <td>attach</td> <td>object</td> <td>否</td> <td>下单参数(卡密商品不用传此参数)</td> <td>手工订单下单模板(以下属性为商品模板中key)</td> </tr> </tbody> </table> <table> <thead> <tr> <th>attach 参数</th> <th>类型</th> <th>是否必填</th> <th>描述</th> <th>示例值</th> </tr> </thead> <tbody> <tr> <td>recharge_account</td> <td>string</td> <td>否</td> <td>充值账号</td> <td>111111</td> </tr> <tr> <td>lblName1</td> <td>string</td> <td>否</td> <td>下单参数一</td> <td>222222</td> </tr> <tr> <td>lblName2</td> <td>string</td> <td>否</td> <td>下单参数二</td> <td>333333</td> </tr> <tr> <td>...</td> <td>...</td> <td>否</td> <td>下单参数N</td> <td>123456</td> </tr> </tbody> </table> <h4><strong>签名示例:</strong></h4> <pre><code>1696644296195{&amp;quot;attach:{&amp;quot;recharge_account&amp;quot;:&amp;quot;111111&amp;quot;,&amp;quot;lblName1&amp;quot;:&amp;quot;222222&amp;quot;,&amp;quot;lblName2&amp;quot;:&amp;quot;333333&amp;quot;},&amp;quot;external_orderno&amp;quot;:&amp;quot;D091952644768932429824&amp;quot;,&amp;quot;id&amp;quot;:1,&amp;quot;mark&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;quantity&amp;quot;:1,&amp;quot;safe_price&amp;quot;:&amp;quot;2.2&amp;quot;,&amp;quot;url&amp;quot;:&amp;quot;http://sc.ka180.cn/notify&amp;quot;}apikey</code></pre> <h4><strong>返回示例:</strong></h4> <pre><code>{ &amp;quot;code&amp;quot;: 200, &amp;quot;msg&amp;quot;: &amp;quot;下单成功&amp;quot;, &amp;quot;data&amp;quot;: { &amp;quot;ordersn&amp;quot;: &amp;quot;API091952652791532879872&amp;quot;, &amp;quot;external_orderno&amp;quot;: &amp;quot;D091952644768932429824&amp;quot; } }</code></pre> <h4><strong>返回data说明:</strong></h4> <table> <thead> <tr> <th>参数名</th> <th>类型</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>ordersn</td> <td>string</td> <td>本地订单号</td> </tr> <tr> <td>external_orderno</td> <td>string</td> <td>三方订单号</td> </tr> </tbody> </table>

页面列表

ITEM_HTML