ADR-004: 雙重支付提供者 (Dual Payment Provider)

狀態: 已接受 (Accepted)

日期: 2026-08-02

背景 (Context)

應用程式提供進階的模擬考功能和訂閱。由於地區限制、服務中斷或商店政策的改變，依賴單一支付閘道可能會有風險。

決策 (Decision)

實作雙重支付架構，使用 RevenueCat 作為主要提供者，並使用原生的 Google Play Billing 作為次要/備援機制。

考慮過的替代方案 (Alternatives Considered)

• 僅 RevenueCat:
  • 優點：輕鬆的跨平台訂閱管理，簡化的 webhook 處理。
  • 缺點：依賴第三方服務，潛在的服務中斷。
• 僅原生 (Native only):
  • 優點：無第三方依賴，直接整合。
  • 缺點：管理收據驗證、伺服器端邏輯和跨平台權限極其複雜。
• Stripe:
  • 優點：非常適合網頁/獨立應用程式。
  • 缺點：如果用於數位商品，將違反應用程式商店規範。

後果 (Consequences)

• 正面影響: 提供者獨立性、更高的可靠性、如果 RevenueCat 停機時的備援能力。
• 負面影響: 更多的樣板程式碼，需要對兩種流程進行測試，潛在的狀態同步問題。

相關文件 (Related Documents)

• 系統設計文件