应用套餐失效

事件分组事件标识
appsubscriptionappsubscription/expiration
当商家订阅的应用套餐失效时，平台会向开发者推送失效通知。
请求头
  • X-Shopline-Topic string required
    事件的唯一标识。
    例子: orders/edited
  • X-Shopline-Hmac-Sha256 string required
    该请求的签名。收到请求后，你需要对该签名进行 验签 以验证数据的真实性和完整性。
    例子: XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM=
  • X-Shopline-Shop-Domain string required
    店铺的域名。
    例子: example.myshopline.com
  • X-Shopline-Shop-Id string required
    店铺 ID。
    例子: 1610418123456
  • X-Shopline-Merchant-Id string required
    商家 ID。
    例子: 2000001234
  • X-Shopline-API-Version string required
    API 版本号。
    例子: v20250601
  • X-Shopline-Webhook-Id string required
    该 Webhook 事件的 ID。
    例子: b54557e48a5fbf7d70bcd043
请求体
  • appkey string
    应用的全局唯一标识符。
    例子: 56978e0b3f33365396d7786a62ed0a03727e3212
  • expirationTime long
    套餐实际失效时间，格式为 10 位秒级时间戳。
    例子: 1735689600
  • expirationType integer
    套餐的失效类型。有效枚举值包含：
    • 0：订阅已失效，宽限期结束，且没有下一期订阅。
    • 1：套餐升级后当前订阅失效。升级后新套餐的生效信息，系统会触发一条 应用套餐生效（需要订阅该事件）的 Webhook 通知。
    • 2：订阅记录从 SHOPLINE 后台手动取消，通常只出现在处理异常的场景。
    • 3：当前订阅已到期，但仍处于宽限期内。
    • 4：当前订阅已失效，且下一期订阅已激活。
  • handle string
    店铺在 SHOPLINE 系统中的唯一标识符。
    例子: smartstore
  • secondChannelId string
    二级渠道标识符，用于标识线下 POS 门店等特定销售渠道。
    适用场景：
    • 当套餐以单个门店为单位销售时，该字段标识具体门店。
    • 当套餐以整个店铺为单位销售时，该字段为空。
    例子: 4567223323
  • spuKey string
    套餐的唯一标识符，在创建套餐时定义。
    例子: premium_email
  • subId string
    失效订阅的原始订单号。
    例子: 6578332207010012345
  • subPackageobject
    失效套餐原始的生效和失效信息。当套餐因升级或取消而失效时，该字段提供对应信息。
  • endAt long
    失效套餐原来的订阅失效时间，格式为 10 位秒级时间戳。
    例子: 1735689600
  • startAt long
    失效套餐原来的订阅生效时间，格式为 10 位秒级时间戳。
    例子: 1706810461
状态码
收到 SHOPLINE 发送的 Webhook 通知后，你需要按照如下 SHOPLINE 要求的格式进行响应。
HTTP/1.1 200 OK
关于如何订阅 Webhooks 及更多 Webhook 响应规则说明，请参考 Webhook 概述。
这篇文章对你有帮助吗？
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
条款协议
隐私
条款
开发者协议
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.