# 四、消息服务使用介绍

消息服务是开放平台为提高应用API调用效率而推出的一种主动推送服务 ，推送内容包括（交易、商品、退款等信息），基于该推送服务，应用获取数据不再需要轮询API，仅需在接收到Fordeal推送的消息时调用API获取即可，大大提高API调用效率。
消息服务使用介绍
1、应用订阅消息
暂未提供入口自主订阅消息，如需使用请联系平台技术。
2、应用接收消息
FDOP会向你注册应用时填写回调URL发起消息推送，应用接收到消息后需返回“ SUCCESS ”表示接收成功， 不返回或者返回其他，均认为消息没有成功通知。
注意：
- 应用未返回“SUCCESS”或者返回其他，FDOP会发起消息重试，请自行保证数据幂等。
- 极端情况下消息可能会重复发送，请自行保证数据幂等。

- 为保证接受消息的性能，建议应用接收到FDOP消息后不做复杂业务逻辑，可将消息转为内部消息异步化处理。
- 请尽量保证回调接口响应时间在100ms以内。

3、通知参数
FDOP消息服务公共参数，每次通知都会放到回调地址中作为 query 参数，目前支持的公共参数有：
| 参数名  说明 | 必选  类型 |
|---------------|------------|------------|------------|
| appKey | 开发者在Fordeal 开放平台创建的应用唯一标识。 | 是 | string |
| format  只支持JSON。 | 是  string |
|------------------------|------------------------------|---------|------------------------|
| sign | 参数签名结果，签名算法参照 “API调用详解” 中 “签名算法” 的介绍。 | 是 | string |
| signMethod  签名的摘要算法，固定为：md5。 | 是  string |
|------------------------------------|------------------------------------------------------|---------|------------------------|
| timestamp | 请求发起时刻的时间，格式为 ISO 8601。示例：2020-01-21T02:10:39+00:00 | 是 | string |
| version  接口版本号，固定1.0 | 是  string |
|---------------------------|---------------------------------------|---------|------------------------|

#### 4、消息格式 消息体会放到 body 中，消息体会参与签名计算。





注意：
为了防止消息在传输 过程中被恶意篡改， FDOP 返回的消息都带有签名(签名算法为MD5)，应用可自行验证签名以保证消息内容准确无误。
示例 ：
以下是一个 订单 待支付消息