v3.6.0 正式用户支付校验、卡密交付与结算升级
- 支付资格更明确，旧版接入继续可用：接入托管登录的应用，仅允许本应用内身份有效的正式用户发起支付；已有 SDK 接入无需升级或增加必填参数。对公到账补录需通过有权限的管理或服务端入口。
- 卡密商品支持库存售卖与外部交付：可批次导入卡密、管理库存并在付款后交付；外部供应商生成的卡密也可回填交付结果和成本，并按批次对账结算。
- 收银台和退款处理更顺畅：切换支付渠道时保留待支付订单，支付宝扫码跳转和微信人民币选价更稳定；后台支持调整退款金额、发起部分退款及跟踪处理状态。
- 订阅生效与优惠更清楚：升级按旧套餐剩余价值抵扣，新套餐次日起享完整周期，待生效套餐自动顺延；符合配置条件的余额套餐购买者也可获得优惠资格，过期积分不再叠加进新余额。
- 托管登录新增账号密码方式：支持账号注册、密码登录及可配置的验证码校验，同时改善微信登录备用入口和桌面端登录结果回传。
- 对账与项目结算更完整：支持支付宝月账单拉取、对公转账收益核对和业务异常筛选；项目成本可按条件导出，并按月批量生成包含退款、手续费及参与人收付明细的成本收益结算单。
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 和权益发放逐步接入同一套开发者服务流程。