千行OSP

千行OSP对外接口


1.10 订单变更通知推送

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>用于推送平台订单至合作商平台</li> </ul> <h5>请求URL</h5> <ul> <li>由合作方提供,运营、技术配置</li> </ul> <h5>请求方式</h5> <ul> <li><strong>POST</strong></li> <li><strong>Content-Type:application/json</strong></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;">orderNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>平台订单号</td> </tr> <tr> <td style="text-align: left;">tradeNo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>合作方订单号</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>订单状态 <strong>0-成功 30-处理中 90-失败</strong></td> </tr> <tr> <td style="text-align: left;">message</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>结果消息</td> </tr> <tr> <td style="text-align: left;">spOrderNo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>供应商订单号</td> </tr> <tr> <td style="text-align: left;">mobile</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>新手机号</td> </tr> <tr> <td style="text-align: left;">expressName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>物流名称</td> </tr> <tr> <td style="text-align: left;">expressNo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>物流单号</td> </tr> <tr> <td style="text-align: left;">activateStatus</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>激活状态 <strong>0-已激活 1-激活失败 -1-未激活</strong></td> </tr> <tr> <td style="text-align: left;">activateTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>激活时间 格式:yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">rechargeStatus</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>首充状态 0-已首充 -1-未首充</td> </tr> <tr> <td style="text-align: left;">rechargeTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>首充时间 格式:yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">rechargeFace</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>首充面值(单位:分)</td> </tr> <tr> <td style="text-align: left;">uploadAddress</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>照片后补上传地址(联通)</td> </tr> <tr> <td style="text-align: left;">custom</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>附加自定义参数</td> </tr> <tr> <td style="text-align: left;">pageUrl</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>下单链接</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>参数签名</td> </tr> </tbody> </table> <p>&gt; #### 签名规则:合作方订单号首尾拼接apiKey后MD5签名,签名结果不区分大小写,md5(apiKey+tradeNo+apiKey)</p> <h5>请求示例</h5> <pre><code class="language-json">POST URL { &amp;quot;orderNo&amp;quot;: &amp;quot;D22091510472536091573&amp;quot;, &amp;quot;tradeNo&amp;quot;: &amp;quot;6451233f4ff44bc2a896585e37354d7e&amp;quot;, &amp;quot;status&amp;quot;: 30, &amp;quot;message&amp;quot;: &amp;quot;下单成功&amp;quot;, &amp;quot;spOrderNo&amp;quot;: &amp;quot;30782262&amp;quot;, &amp;quot;mobile&amp;quot;: &amp;quot;198xxxx9342&amp;quot;, &amp;quot;expressName&amp;quot;: &amp;quot;京东配送&amp;quot;, &amp;quot;expressNo&amp;quot;: &amp;quot;JDVC15760833896&amp;quot;, &amp;quot;activateStatus&amp;quot;: 0, &amp;quot;activateTime&amp;quot;: &amp;quot;2022-09-12 14:25:04&amp;quot;, &amp;quot;uploadAddress&amp;quot;:&amp;quot;https://uc.gtimg.cn/jkssnPqn&amp;quot;, &amp;quot;custom&amp;quot;:&amp;quot;&amp;quot;, &amp;quot;pageUrl&amp;quot;:&amp;quot;&amp;quot;, &amp;quot;sign&amp;quot;: &amp;quot;92b23e7526a49a381b225b6208eb1ad6&amp;quot; }</code></pre> <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;">无</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>推送结果(success-成功,其他-失败)</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code>success</code></pre> <p>&gt; ##### 备注</p> <ul> <li><strong>注意: 返回字普通字符串success,不是json格式</strong></li> </ul>

页面列表

ITEM_HTML