優易點統一入口開發文件

這頁解決什麼問題：幫助你先確定《優易點統一入口》的唯一推薦接入路線。
適用場景：標準託管用戶，希望盡快完成網頁支付與託管登入整合。
完成後你將得到什麼：一條可直接交給 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
• 不要把高級覆寫項當成標準託管接入的必填項