数据字典
subscription_status（订阅状态）
| 取值 |
含义 |
PENDING_ACTIVATE |
待激活 |
ACTIVE |
生效中 |
SUSPENDED |
已暂停 |
CANCELLED |
已取消 |
FAILED |
订阅失败（如首期支付失败、鉴权失败等，与商户主动取消区分） |
EXPIRED |
已过期 |
trade_status（交易状态）
| 取值 |
含义 |
PENDING |
待处理 |
PROCESSING |
处理中 |
CHANNEL_PENDING |
渠道处理中（由查单推进，不占失败重试次数） |
SUCCESS |
成功 |
FAILED |
失败 |
CANCELLED |
已取消 |
refund_status（退款状态）
| 取值 |
含义 |
PENDING |
待处理（计入可退占用） |
PROCESSING |
处理中（计入占用） |
SUCCESS |
退款成功（计入占用） |
FAILED |
退款失败（不占用；同商户退款单号不可复用） |
3.4 period_type（周期类型）
| 取值 |
含义 |
DAY |
日 |
WEEK |
周 |
MONTH |
月（按签约日历日对齐的 N 个月间隔） |
QUARTER |
季 |
HALF_YEAR |
半年 |
YEAR |
年 |
MONTH_FIXED_DAY |
自然月固定日（每月在 fixed_day 扣款；当月无该日取当月最后一日） |
event_type（异步通知事件）
| 取值 |
含义 |
PAYMENT |
支付/扣款类通知 |
SUBSCRIPTION |
订阅状态变更类通知（普通续期成功不推本类型） |
REFUND |
退款结果通知 |
绑卡成功异步通知不以 event_type 区分，以 trade_status 判定。
3.6 pay_method（支付方式）
| 取值 |
含义 |
PROTOCOL_CARD |
协议支付（银行卡代扣等） |
ACCOUNT_BALANCE |
账户余额（预留） |
DEFAULT |
默认档，与协议支付共用当前实现 |
applied_pricing_type / pricing_type（营销定价类型）
| 取值 |
含义 |
FREE_TRIAL |
免费试用 |
FIRST_PERIOD_DISCOUNT |
首期优惠 |
TIERED_DISCOUNT |
阶梯折扣 |
FIXED_DISCOUNT |
固定折扣率 |
NO_DISCOUNT |
无优惠（使用产品原价） |
MERCHANT_SPECIFIED |
商户指定金额 |
product_status / strategy_status（产品/策略状态）
| 取值 |
含义 |
ENABLED |
启用 |
DISABLED |
禁用 |
错误码
公共错误码
| 状态码 |
错误码 |
描述 |
解决方案 |
| 400 |
PARAM_ERROR |
参数错误 |
请根据错误提示正确传入参数 |
| 401 |
SIGN_ERROR |
验证不通过 |
请参阅【开发指引-整体说明】排查签名 |
| 500 |
SYSTEM_ERROR |
系统异常，请稍后重试 |
请稍后重试 |
业务错误码
| 状态码 |
错误码 |
描述 |
解决方案 |
| 409 |
ORDER_DUPLICATED |
重复请求 |
幂等命中 |
| 404 |
RESOURCE_NOT_EXISTS |
订阅不存在 |
请核实订阅号是否正确 |
| 404 |
ORDER_NOT_FOUND |
查询对象不存在 |
请核实扣款单/退款单是否存在 |
| 404 |
MCH_NOT_EXISTS |
商户号不匹配 |
请确认传入商户号与订阅归属一致 |
| 402 |
USER_PAYING |
结果未决 |
渠道处理中，请稍后查询 |
| 402 |
TRADE_ERROR |
业务失败 |
请根据返回信息检查业务条件 |
| 404 |
NOT_FOUND |
产品未命中 |
请核实外部产品编号 |
| 200 |
ORDER_CLOSED |
订阅状态不合法 |
当前状态不允许取消或变更 |
| 502 |
SERVICE_UNAVAILABLE |
服务暂不可用 |
绑卡通道暂不可用 |
bank_card_type（银行卡类型，绑卡）
