计费事件

当集成方 Space 发生计费消耗时,Tencent eSign 向集成方配置的回调地址推送计费事件通知。

事件类型

billing_usage_deductedevent
计费额度消耗 — 集成方 Space 内发起信封、eKYC 等操作时,额度发生扣减

载荷结构

EventTypestring
事件类型,固定为 billing_usage_deducted
OccurredAtstring
事件发生时间,RFC3339 格式,如 2026-06-01T10:00:00Z
AppIdstring
触发消耗的集成应用 AppId(子客消耗时为第三方应用 AppId)
SpaceIdstring
发起消耗的 Space ID(合同发起方所在的 Space)
UserIdstring
发起消耗的用户 ID(对应集成方侧的用户标识)
EnvelopeIdstring
关联信封 ID;若消耗不涉及信封(如 eKYC)则为空
UsageTypestring
消耗类型,枚举值:ses(SES 信封)/ ekyc(eKYC 实名认证)/ member(成员席位)
PackageNamestring
消耗套餐名称
Quantityinteger
本次消耗份数
Remarkstring
备注,当前为空

载荷示例

{
  "EventType": "billing_usage_deducted",
  "OccurredAt": "2026-06-01T10:00:00Z",
  "AppId": "APxQk2mN8pR4vW1yH3jT5bZ6aE7cF0ab",
  "SpaceId": "SGSPxQk2mN8pR4vW1yH3jT5bZ6aE7cF0",
  "UserId": "SG_1234567890",
  "EnvelopeId": "ENV_xxx",
  "UsageType": "ses",
  "PackageName": "SES 信封包 - 100份",
  "Quantity": 1,
  "Remark": ""
}