服务单状态变更回调

该接口由电商平台实现。请求头 xmh-hmc-signature（算法见鉴权 §4.2）。仅 HTTP 200 视为成功，不解析 body 的 errCode。

服务单每次状态变更时推送。

请求方式：POST（Content-Type: application/json）
码与中英文对照见保单权益状态（本回调为 serviceState / serviceStateDesc；查询为 policyStatus / policyStatusDesc / policyStatusDescEn）
连续状态跳变会各推一条；请按 serviceOrderId + serviceState 做幂等

完整字段说明见 API 接口文档 · webhook serviceStateChanged。不要对着 OpenAPI 域名点 Send。

接口入参示例：

{
    "platformOrderId": "6462084809006",
    "serviceOrderId": "20251010XPP3310437F8F86",
    "serviceType": "PP",
    "serviceState": 5,
    "serviceStateDesc": "Refunded",
    "eventTime": "2026-08-04T10:11:12+08:00"
}

{
    "platformOrderId": "6462084809007",
    "serviceOrderId": "20251010XSP3310437F8F87",
    "serviceType": "SP",
    "serviceState": 3,
    "serviceStateDesc": "Effective",
    "eventTime": "2026-08-04T10:15:30+08:00"
}

serviceState 取值表（默认英文）

serviceState	serviceStateDesc	中文
1	Uninsured	未投保
2	Insured	已投保
3	Effective	已生效
5	Refunded	已退保
7	Expired	已过保
8	Cancelled	已取消

接口响应：

HTTP 200 视为接收成功；非 200 视为失败并重试。不要求 body 含 errCode。

附注

本回调与「回调-服务生效」相互独立：生效通知仍走原生效回调，服务单状态变更通知走本回调（每次状态变更都会推送一条），电商平台可按需接入；两者同时配置时，“已生效”时刻会收到两条推送（生效回调 + 本回调 serviceState=3）。
状态推送以”变更发生”为准：重试可能导致重复推送，电商平台侧建议以 serviceOrderId + serviceState 做幂等处理。
正常情况下商户不会通过本回调收到 serviceState=7（已过保 / Expired）。
回调地址由双方在店铺接入配置（openapiConfig.callEndpoints 中的 openApiServiceStateChangeCallBack）中约定，未配置该回调地址的店铺不会推送。