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 和權益發放逐步接入同一套開發者服務流程。