优易点统一门户开发文档

这页解决什么问题：帮助你先确定《优易点统一门户》的唯一推荐接入路线。
适用场景：标准托管用户，希望尽快完成网页支付与托管登录接入。
完成后你将得到什么：一条可直接交给 AI 或开发者执行的默认实现路径。

优易点统一门户提供什么

优易点统一门户负责托管以下能力：

• 产品、价格与支付渠道配置
• 产品列表与产品下权益的统一读取
• 托管支付页面与订单创建链路
• 托管登录页面与多渠道身份接入
• 服务端订单、权益与登录校验 API
• 周期性订阅权益的自动维护与周期更新

当前仓库中的真实 SDK 版本为 @youidian/sdk v3.1.0。

唯一推荐接入路径

默认只讲一条路线：

1. 安装 @youidian/sdk
2. 前端从 @youidian/sdk/client 使用 PaymentUI 打开托管支付
3. 前端从 @youidian/sdk/client 使用 LoginUI 打开托管登录
4. 后端从 @youidian/sdk/server 使用 PaymentClient
5. 支付成功后由你的后端查询订单、读取权益并完成业务发放
6. 登录成功后由你的后端校验 loginToken，再建立本地用户与会话

默认路径中：

• 支付前通常先拉产品列表，再用 productCode 发起支付
• 登录使用 loginToken
• 不要求业务侧先创建订单
• 用户权益默认由统一平台托管
• 不要求配置 apiUrl、checkoutUrl、loginUrl、baseUrl

从 SDK v3.1.0 开始，如果集成方需要在自己的价格页判断“是否已购买”“是否应该显示升级入口”，可以在后端调用 getActiveSubscription(userId)。这个判断应由集成方后端完成，而不是交给公开托管 checkout 页面来做。

特殊控制需求、私有部署、自定义域名与显式建单，请看高级接入。

推荐支付流程总览

你的后端
  -> getProducts(...)
  -> 你的价格页展示产品、价格、产品权益
  -> 你的前端 PaymentUI.openPayment({ appId, userId, productCode })
  -> 优易点统一门户托管支付页
  -> 用户确认产品并完成支付
  -> 优易点统一门户创建并推进订单
  -> 前端收到成功回调 orderId
  -> 你的后端查询订单 / 权益
  -> 你的系统发放权益或刷新账户状态

推荐登录流程总览

你的前端
  -> LoginUI.openLogin({ appId })
  -> 优易点统一门户托管登录页
  -> 用户完成登录
  -> 前端收到 loginToken
  -> 前端把 loginToken 提交给你的后端
  -> 你的后端 verifyLoginToken(loginToken)
  -> 你的系统匹配或创建本地用户并建立会话

文档阅读顺序

1. 安装
2. 支付集成
3. 登录集成
4. 高级接入
5. 支付渠道参考
6. 微信小程序集成
7. 接入 Checklist

常见错误避免项

• 不要把 @youidian/sdk/login 当成默认入口
• 不要在默认支付路径里先写自建订单流程
• 不要信任前端登录结果本身，必须校验 loginToken
• 不要把高级覆盖项当成标准托管接入的必填项