云号卡

云号卡服务


异步消息通知

<ul> <li>当用户完成下单,平台会把相关生产结果通过异步回调的方式通知商户,商户服务器需要实现接收处理,并按文档规范返回应答。支付结果通知是以POST方法给商户订单提交的URL发送通知,通知的数据采用JSON格式进行编码。</li> <li>平台通知时会对通知数据进行签名,商户应当验证签名,以确认请求来自平台消息,而不是来自其他的第三方。</li> <li>商户成功接收到回调通知后应返回200,这样平台才会认为通知得到了正常的处理。同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。推荐的做法是,当商户系统收到通知进行处理时,先检查对应业务数据的状态,并判断该通知是否已经处理。如果未处理,则再进行处理;如果已处理,则直接返回结果成功。 <h3>具体参数</h3></li> </ul> <table> <thead> <tr> <th>字段</th> <th>类型</th> <th>备注</th> </tr> </thead> <tbody> <tr> <td>appId</td> <td>String</td> <td>由平台提供,每个应用都对应一个唯一的appId</td> </tr> <tr> <td>timestamp</td> <td>String</td> <td>毫秒时间戳</td> </tr> <tr> <td>sign</td> <td>String</td> <td>将 appkey、timestamp、appSecret 对应的字符串按此固定顺序拼接后,使用 SHA256 算法加密</td> </tr> <tr> <td>oid</td> <td>String</td> <td>平台订单号</td> </tr> <tr> <td>outOrderNo</td> <td>String</td> <td>外部订单号</td> </tr> <tr> <td>expressCompany</td> <td>String</td> <td>快递公司 有数据时返回</td> </tr> <tr> <td>expressNo</td> <td>String</td> <td>快递单号 有数据时返回</td> </tr> <tr> <td>produceMobile</td> <td>String</td> <td>生产号码 有数据时返回</td> </tr> <tr> <td>state</td> <td>Integer</td> <td>订单状态,详见状态说明附录</td> </tr> <tr> <td>remark</td> <td>String</td> <td>备注 开卡失败返回</td> </tr> <tr> <td>rechargeAmount</td> <td>Double</td> <td>充值金额,单位元 激活有数据才返回</td> </tr> <tr> <td>rechargeTime</td> <td>date</td> <td>充值日期 毫秒时间戳 激活有数据才返回</td> </tr> <tr> <td>commissionAmount</td> <td>Double</td> <td>秒返日结佣金,单位元 可结算状态(71)才返回</td> </tr> <tr> <td>activeTime</td> <td>date</td> <td>激活时间 毫秒时间戳 激活有数据才返回</td> </tr> </tbody> </table> <p>商户成功接收到回调通知后应返回200 return 200; <img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=3778a2178aede7d2d65bd1b498741f2c&amp;amp;file=file.png" alt="" /></p>

页面列表

ITEM_HTML