理赔同步回调
该接口由电商平台侧实现(webhook)。域名与接口名由电商平台定义和提供。
Xcotton 将理赔结果同步给电商平台。请求头 xmh-hmc-signature。仅 HTTP 200 成功(见 鉴权 §4.2)。不解析 body 中的 errCode。
完整字段说明见 API 接口文档 · webhook claimUpdated。不要对着 OpenAPI 域名点 Send。
注意:
- 收款方式 JSON 键是
claimPaymentMethod(报案入参才是paymentMethod)。 - 理赔单顶层金额
claimApplyMoney/claimMoney/claimServiceFee使用币种主单位字符串;与 ClaimQuery 理赔单顶层使用「最小货币单位字符串」不同。 - 商品行
claimpayoutType不属于当前契约;若历史报文仍携带该字段请忽略。赔付方式见理赔单顶层的claimCompensationType。 - 为兼容历史用户,商品行
orderGoodsId当前与skuId值相同,并不是真实订单商品行 ID;新接入请直接使用skuId。 - 本回调的
claimPaymentTime/claimGenTime/claimTime沿用YYYY-MM-DD HH:mm:ss;ClaimQuery 的同类时间使用 RFC3339。 claimType/claimInsuranceType见 理赔类型。claimType = 3(延误赔偿)或source = auto_delay时,回调额外携带 Delay 自动赔付扩展字段(source/trackingNumber/carrierCode/carrierName/promisedDeliveryTime/actualDeliveryTime/delayDays/delayTier/points/giftCardUsd/autoCompensationTaskId),预设计,最终字段以研发确认为准。
Delay 自动赔付扩展示例(claimType=3,预设计):
Section titled “Delay 自动赔付扩展示例(claimType=3,预设计):”{ "orderId": "1234567890", "claimId": "CL2024010100002", "claimType": 3, "claimInsuranceType": 3, "claimState": 3, "source": "auto_delay", "trackingNumber": "RR123456789CN", "carrierCode": 3011, "carrierName": "China Post", "promisedDeliveryTime": "2026-08-10T23:59:59Z", "actualDeliveryTime": "2026-08-15T08:30:00Z", "delayDays": 5, "delayTier": { "minDelayDays": 4, "maxDelayDays": 7, "method": "CASH", "amountUsd": "5.00" }, "compensationMethod": "CASH", "claimMoney": "5.00", "claimMoneyCurrency": "USD", "autoCompensationTaskId": "DELAY_TASK_202608170001"}接口入参示例:
Section titled “接口入参示例:”{ "orderId": "1234567890", "claimId": "CL2024010100001", "claimType": 1, "fileLinks": [ "http://example.com/file1.jpg" ], "comments": "商品损坏,需理赔。", "claimPaymentObj": 1, "claimPaymentMethod": 1, "claimInsuranceType": 3, "claimItems": [ { "itemId": "001", "productId": "p001", "skuId": "ABC123", "orderGoodsId": "ABC123", "variantId": "V001", "itemName": "商品名称1", "pic": "http://example.com/item1.jpg", "itemNum": 2, "claimType": 1, "claimState": 2 } ], "claimApplyMoney": "5000.00", "claimMoney": "4500.00", "claimMoneyCurrency": "USD", "claimServiceFee": "50.00", "claimServiceFeeCurrency": "USD", "claimPaymentState": 2, "claimPaymentTime": "2026-01-02 15:04:05", "claimPayTransactionNo": "TXN123", "claimCompensationType": 1, "claimReviewState": 1, "claimState": 3, "claimGenTime": "2026-01-02 15:04:05", "claimTime": "2026-01-02 15:04:05"}