数据字典与枚举说明

1.1 订阅状态 subscription_status

对应代码：SubscriptionStatusEnum

取值 说明
PENDING_ACTIVATE 待激活
ACTIVE 生效中
SUSPENDED 已暂停
CANCELLED 已取消
FAILED 订阅失败（如首期支付失败、鉴权失败等，与商户主动取消区分）
EXPIRED 已过期

1.2 交易状态 trade_status

对应代码：DeductionStatusEnum（扣款单状态）

取值 说明
PENDING 待处理
PROCESSING 处理中
CHANNEL_PENDING 渠道处理中
SUCCESS 成功
FAILED 失败
CANCELLED 已取消

1.3 周期类型 period_type

对应代码：CycleTypeEnum；配置/落库另支持 MONTH_FIXED_DAY（自然月固定日，需配合 fixed_day）

取值 说明
DAY 日
WEEK 周
MONTH 月（按签约日历日对齐的 N 个月间隔）
QUARTER 季
HALF_YEAR 半年
YEAR 年
MONTH_FIXED_DAY 自然月固定日（每月在 fixed_day 扣款；当月无该日取当月最后一日）

1.4 异步通知事件 event_type

对应代码：NotifyBusinessTypeConstants

取值 说明
PAYMENT 支付/扣款类通知
SUBSCRIPTION 订阅生命周期类通知（签约、变更、取消等）
REFUND 退款类（预留）

1.5 支付方式 pay_method

对应代码：DeductionPaymentMethodEnum

取值 说明
PROTOCOL_CARD 协议支付（银行卡代扣等）
ACCOUNT_BALANCE 账户余额（预留）
DEFAULT 默认档，与协议支付共用当前实现

1.6 营销定价类型 applied_pricing_type

对应代码：PricingTypeEnum

取值 说明
FREE_TRIAL 免费试用
FIRST_PERIOD_DISCOUNT 首期优惠
TIERED_DISCOUNT 阶梯折扣
FIXED_DISCOUNT 固定折扣率
NO_DISCOUNT 无优惠（使用产品原价）
MERCHANT_SPECIFIED 商户指定金额

1.7 产品状态 product_status

对应代码：ProductStatusEnum

取值 说明
ENABLED 启用
DISABLED 禁用

1.8 策略状态 strategy_status

对应代码：ProductStatusEnum（与产品配置共用同一套状态码）

取值 说明
ENABLED 启用
DISABLED 禁用

1.9 金额与数值类型

金额字段（如 period_amount、original_amount、actual_amount、specified_amount）单位为 分，类型为 整数（integer / JSON number）。

期数、次数、优先级等计数字段同样使用 integer。

1.10 主要字段含义

字段 适用场景 含义
subscription_no 订阅 订阅号
trade_no 扣款 扣款单号
out_trade_no 订阅/通知 商户签约订单号
merchant_user_id 订阅/通知 用户标识
period_amount 订阅 每期扣款金额（分）
product_status 产品查询 产品配置状态
strategy_status 产品查询 营销策略状态
specified_amount 变更请求 商户指定每期金额（分）
error_code 失败场景 错误码
error_message 失败场景 错误描述

##