跳转到内容

理赔同步回调

该接口由电商平台侧实现(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"
}
{
"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"
}