### 1.消息说明 开放平台向接入商的系统实时推送业务变更消息，接入商系统收到消息后，进行相应的处理，实现数据同步，从而满足接入商系统业务功能。 ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=2b115dfb627cf76b326e8695bf562183#2%E6%8E%A8%E9%80%81%E6%96%B9%E5%BC%8F)2.推送方式 为避免接入商轮询，开放平台采用推送的方式，以`http post`的形式向商户指定的回调地址(自行在聚合供应链商户后台的应用上配置)进行推送。推送的消息数据(Body中除sign以外的部分)会进行消息摘要([详见签名规则](签名规则.md))，接收方收到数据后，需对数据进行验签，以保证数据的可靠性。接收方正常处理完消息后，需回执`SUCCESS`，若接收或处理失败，消息会自动重发(参见生命周期) ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=2b115dfb627cf76b326e8695bf562183#3%E7%94%9F%E5%91%BD%E5%91%A8%E6%9C%9F)3.生命周期 正常情况下，每条消息最多会进行8次通知 (通知的间隔频率一般是：`立即`,`10s`,`30s`,`1m`,`2m`,`3m`,`4m`,`5m`) ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=2b115dfb627cf76b326e8695bf562183#4%E5%B9%82%E7%AD%89%E5%A4%84%E7%90%86)4.幂等处理 由于网络原因、接入商系统原因，或接入商系统接收成功但未正常回执等，会触发消息的重试机制，接收方需要对同一个id的消息多次投递结果实现幂等。 ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=2b115dfb627cf76b326e8695bf562183#5%E6%8E%A8%E9%80%81%E6%95%B0%E6%8D%AE%E6%A0%BC%E5%BC%8F)5.推送数据格式 **请求方式：**`POST` **请求参数** Headers | 参数名称 | 参数值 | 必填 | 类型 | 备注 | | --- | --- | --- | --- | --- | | Content-Type | application/json | 是 | String | | Body | 名称 | 类型 | 必须 | 示例值 | 备注 | | --- | --- | --- | --- | --- | | id | java.lang.Long | 是 | 1601051353780715520 | 消息唯一标识 | | pushTime | java.lang.Long | 是 | 1670555403922 | 消息推送时间 | | type | java.lang.String | 是 | life.film.order.status.change | 消息类型 | | data | java.lang.String | 是 | {“orderSubStatus”:“2”,“dbyOrderId”:“1411656131044918722561”,“orderSubStatusName”:“受理中”} | 推送数据 (json字符串) | | sign | java.lang.String | 是 | 21A5C3C007A5998166602C6B1133E47C | 签名 | 示例 ~~~json { "id":1601051353780715520, "pushTime":1670555403922, "type":"life.film.order.status.change", "data":"{\"orderSubStatus\":\"2\",\"dbyOrderId\":\"1411656131044918722561\",\"orderSubStatusName\":\"受理中\"}", "sign":"21A5C3C007A5998166602C6B1133E47C" } ~~~ > 基于`type`字段值，区分不同的消息类型，各种类型的消息，`data`字段对应的json字符串格式不同 ## [](https://duobaoyu.com.cn/documentcenter?onlyFlag=2b115dfb627cf76b326e8695bf562183#%E6%B6%88%E6%81%AF%E7%B1%BB%E5%9E%8B)消息类型 * * * ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=2b115dfb627cf76b326e8695bf562183#%E8%AE%A2%E5%8D%95)订单 #### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=2b115dfb627cf76b326e8695bf562183#%E8%AE%A2%E5%8D%95%E7%8A%B6%E6%80%81%E5%8F%98%E6%9B%B4)订单状态变更 > type:`life.film.order.status.change` * * * **`data`字段对应的json数据格式:** | 名称 | 类型 | 示例值 | 描述 | | --- | --- | --- | --- | | dbyOrderId | String | 1411601121460812906496 | 小象订单号 | | orderSubStatus | String | 2 | 订单状态 | | orderSubStatusName | String | 受理中 | 订单状态描述 | **收到消息后的处理方式：** 通过[查询电影票订单详情](H5电影订单详情.md)接口，获取订单最新的信息，将每个子订单的最新状态更新到接入方系统中，结合接入方系统的业务，对不同的状态做其他处理