API Reference
API Reference

业务对象

折扣(Discount)业务对象字段说明

属性名类型描述
idstring折扣对象的唯一 ID
discount_namestring折扣名称
statusstring折扣状态:
  • draft:折扣已创建但尚未激活或对用户可见
  • not_started:折扣已定义,但其开始时间尚未到达
  • ongoing:折扣当前处于活动状态并可供使用
  • completed:折扣已结束,不再可供使用
discount_codestring在结账时应用的折扣代码
discount_methodstring折扣方式:仅当设置为 "discount_code" 时才能使用折扣代码:
  • discount_code:通过折扣代码折扣
starts_atstring折扣开始时间(UTC 格式),空字符串表示无限制
ends_atstring折扣结束时间(UTC 格式),空字符串表示无限制
created_atstring创建时间,UTC 格式字符串
updated_atstring最后更新时间,UTC 格式字符串
These developer docs retire on 2026-08-30. Visit the new docs: NEW DOCS本开发者文档将于 2026-08-30下线,请访问新版文档: 新文档