应用订阅状态更新

Webhookapp/subscriptions_update

周期性收费状态更新时触发。

需要 shop 访问权限。最低支持版本：202207。

请求头

X-Shoplazza-Topicstring
触发本次推送的事件，例如 orders/create
示例： orders/create
X-Shoplazza-Hmac-Sha256string

请求体的 HMAC-SHA256 签名（base64 编码），使用应用的 Client Secret 生成，用于验证请求来自 Shoplazza

X-Shoplazza-Shop-Domainstring
产生该事件的店铺域名
示例： example.myshoplaza.com
X-Shoplazza-Api-Versionstring
序列化 payload 使用的 API 版本
示例： 2025-06
X-Shoplazza-Deduplication-IDstring

本次推送的去重 ID，同一事件重发时保持不变，用于幂等去重

请求体

数据结构

activated_onstring

订阅激活日期

application_idstring

应用 ID

billing_onstring

下次账单日期

cancelled_onstring

收费取消日期

capped_amountstring

用量计费的封顶金额

charge_interval_daysinteger

收费间隔天数

charge_timesinteger

收费次数（0 表示无限）

idstring

周期性应用收费 ID

namestring

向商家展示的收费名称

pricestring

周期性收费金额

remaining_charge_timesinteger

剩余收费次数（无限时恒为 1）

statusstring

周期性应用收费的当前状态

store_idinteger

店铺 ID

testboolean

是否为测试收费

trial_daysinteger

订阅提供的试用天数

trial_ends_onstring

试用期结束日期

updated_atstring

最后更新时间，ISO-8601 格式

示例

{
  "activated_on": "string",
  "application_id": "string",
  "billing_on": "string",
  "cancelled_on": "string",
  "capped_amount": "string",
  "charge_interval_days": 0,
  "charge_times": 0,
  "id": "string",
  "name": "string",
  "price": "string",
  "remaining_charge_times": 0,
  "status": "string",
  "store_id": 0,
  "test": true,
  "trial_days": 0,
  "trial_ends_on": "string",
  "updated_at": "string"
}