v3.5.1 明确区分订阅购买与升级
- SDK v3.5.0 已发布：服务端集成可以直接查询用户真正可升级的订阅产品，不再由业务方自行推断套餐等级。
- 普通购买和升级意图更明确：创建订单时可以使用
STANDARD保留普通或重复购买，使用UPGRADE限制为仅向上升级。 - 历史套餐可以继续升级：升级选项会把旧套餐映射到当前等级体系，同时保留原订阅周期和按剩余时长计算的抵扣。
v3.5.0 可过期积分池与产品配置保护
- 支持可过期积分扣取：集成方可以先扣订阅周期积分，在同一个 key 内优先扣最早到期的授权记录，不足时再回退到永久积分或其他权益 key。
- SDK 和 HTTP 都能查看积分桶：
@youidian/sdkv3.3.11 新增有序积分池扣取和有效积分桶查询能力，服务端直连集成也可以使用对应 HTTP 接口。 - 产品列表直接展示关键配置标识：商品后台现在会在列表中显示自动试用、库存和订阅组配置状态，已配置订阅组时会直接显示订阅组代码。
- 数值型权益 key 配置更安全：产品配置会提示同一个订阅组内保持订阅周期 key 一致，并阻止同一个应用内把同一个数值型 key 复用到冲突的产品范围。
v3.4.0 自定义充值、退款记录与后台搜索升级
- 点数类产品支持自定义金额充值：管理员可以按币种配置最低金额、最高金额、步进和兑换比例；托管收银台和 SDK 集成都可以让用户输入想充值的具体金额。
- 收银台会在服务端校验充值限制：托管收银台、嵌入式 PayPal 和 SDK 创建订单都会按产品配置校验自定义金额，并在支付成功后发放正确的数值型权益。
- 退款记录更容易审计：后台退款和 PayPal/提供方退款 Webhook 现在会保留结构化退款记录，管理员也可以为历史已退款订单补录缺失的退款记录。
- 订单后台搜索更精准：订单列表现在拆分商户订单号、用户昵称和渠道交易号筛选，让对账和客服排查更快。
- 支付操作更安全、更清晰：托管和 API 下单会拒绝原始银行卡数据，收银台代理跳转更稳定，商品列表也可以直接切换商品启用状态。
v3.3.0 嵌入式登录、应用共享与回调稳定性升级
- SDK 登录默认使用嵌入式模态窗口：接入方可以让手机号和微信登录留在当前页面内完成；Google 和 Apple 授权在提供方要求时仍会使用授权弹窗。
- 手机号短信登录可用于托管登录：用户可以完成手机号登录和绑定，管理员也可以在登录后台测试短信渠道并查看发送记录。
- 应用共享协作更安全：支付应用和支付渠道现在支持共享流程，团队协作时无需重复复制应用配置。
- 后台运营更容易核对：支付后台新增更丰富的统计报表、商户订单标识展示和商品 code 上线前校验。
- 支付回调和 Webhook 更稳定：提供方 Webhook 投递、回调结果页、退款渠道处理，以及 Stripe/PayPal 订单元信息在托管和 API 集成中更一致。
v3.2.0 HTTP 集成文档与更稳的托管登录回跳
- 新增 HTTP 集成文档路线：现在即使不使用 SDK 包装层，你也可以直接按照完整的 API 文档接入鉴权、支付订单、登录校验、Webhook 和上线检查。
- 托管登录完成更稳定：OAuth 登录现在会落到专用结果页完成最终状态确认，让弹窗登录和嵌入式登录流程结束得更一致。
- 共享回调域名更容易部署：当回调放在 Nginx 反代或共享 passport 域名后时，托管登录现在能更稳定地保留正确的返回域名和带前缀的 API 路径，减少登录后跳转失败。
- PayPal 结账改为走统一下单链路：嵌入式 PayPal 流程现在会复用主结账流程的下单规则，让价格计算、校验逻辑和订阅资格限制更一致。
v3.1.0 订阅升级与托管流程体验升级
- 订阅升级支持按剩余时长抵扣：托管结账现在可以根据当前有效订阅的剩余时长计算抵扣金额，并自动应用到更高等级套餐，让用户在支付前更清楚地看到本次应付金额。
- 升级限制提示更明确：重复购买同等级订阅或购买更低等级订阅时，现在会直接给出清晰提示，减少托管结账里误购重复套餐或误降级的情况。
- 托管登录完成过程更稳定：OAuth 回调现在会回到托管 connect 页面完成最终登录状态确认，减少回调落点不一致带来的困惑，让登录完成体验更一致。
- 登录、支付和后台的用户对应关系更清楚：接入方现在有更明确的指引来复用同一个平台用户 ID，后台订单列表在可匹配时也会显示关联的注册账号信息。
- 权益到期与升级替换结果更准确：订阅变更后，已过期权益会被更安全地清理，后台显示会更接近真实生效状态，升级后的订阅权益替换也更可预期。
- 新增托管主题选项：托管登录和结账现在支持新的极简黑白主题，适合希望使用更克制视觉风格的团队。
历史更新
- 应用配置成为支付、登录、商品和权益的统一接入主体。
- 托管收银台、SDK 下单和订单状态查询形成基础支付闭环。
- 托管登录、Webhook 和权益发放逐步接入同一套开发者服务流程。