hyperswitch-prism

hyperswitch-prism 是什麼？

hyperswitch-prism 是一個無狀態的統一連接器函式庫，用於整合付款處理器。它設計提供單一請求/互動格式，讓相同呼叫模式可在多個付款處理器上使用，並減少程式碼修改。

Prism 由 Hyperswitch 後端團隊提取並維護，Hyperswitch 是一個開源付款平台。專案描述 Prism 為轉換層，專注連接器整合一致性，而將金庫/代幣化、重試及路由邏輯等問題留給 Hyperswitch。

主要功能

• 跨連接器統一請求格式： 相同的授權呼叫適用多個處理器（例如 Stripe、Adyen），無需額外針對各處理器的程式碼。
• 無狀態函式庫（無資料庫、無儲存 PII）： Prism 不需資料庫且避免儲存個人資料；函式庫不儲存或記錄憑證，憑證僅存在於 HTTP 用戶端生命週期內。
• 設計上控制 PCI 範圍： 函式庫可避免將卡片資料引入 Prism；卡片資料是否流經函式庫為使用者選擇，可使用付款處理器金庫或使用者提供的 PCI 認證金庫。
• 持續連接器測試與公開狀態模型： 連接器持續針對真實沙盒/生產環境測試，狀態圖例涵蓋支援中、進行中/部分支援及需驗證狀態。
• 慣用多語言介面（依專案文件）： Prism 描述為類型安全的慣用介面，以多語言 SDK 封裝。

如何使用 hyperswitch-prism

1. 選擇適合語言的 Prism SDK 並檢閱 SDK 指南，了解認證與請求模式。
2. 使用 Prism 統一格式撰寫付款請求（例如，跨不同付款處理器使用相同授權呼叫結構）。
3. 選擇敏感付款資料處理位置：使用自家 PCI 認證金庫或付款處理器金庫，符合專案註記 Prism 未內建金庫/代幣化服務。
4. 驗證連接器涵蓋範圍 使用專案的連接器涵蓋/狀態頁面，因為 Prism 描述各連接器支援程度不一。

使用情境

• 多處理器結帳整合： 您想將付款作業路由至多個付款處理器，同時透過 Prism 統一請求格式將應用程式碼變更維持最小。
• 減少整合層狀態與儲存資料： 團隊偏好無狀態連接器層，Prism 本身不需資料庫且不儲存或記錄憑證。
• 透過金庫選擇符合 PCI 責任： 您想控制卡片資料是否在自家基礎設施處理，並選擇付款處理器金庫或自家 PCI 認證金庫。
• 工程團隊長期維護連接器邏輯： 您需要持續針對沙盒/生產環境測試的連接器整合層，並追蹤各連接器狀態。
• 大型付款平台內的轉換層整合： 您使用 Prism 作為轉換層，而將重試/路由邏輯實作於其他地方（專案指向 Juspay Hyperswitch）。

常見問題

Prism 是否負責重試和路由邏輯？
否。儲存庫指出，重試或路由邏輯位於 Juspay Hyperswitch 中；Prism 僅作為轉換層。

Prism 是否包含內建金鑰庫或代幣化服務？
否。這是設計選擇；您可自帶金鑰庫或使用付款處理器的金鑰庫。

Prism 是否儲存憑證或 PII？
儲存庫指出，函式庫不儲存或記錄憑證，它是無狀態的、無資料庫，且不儲存 PII。憑證僅在您的 HTTP 用戶端存活期間存在。

如何得知支援哪些付款處理器和付款方式？
Prism 發布連接器涵蓋範圍，附上圖例標示支援（完整實作並測試）、不適用/不支援、進行中/部分，以及需對實境環境驗證的實作。

多個處理器需要實作多少付款呼叫？
儲存庫的核心主張是，單一請求結構可讓相同的授權呼叫適用於 Stripe 和 Adyen 等處理器，無需額外處理器特定程式碼。

替代方案

• 直接逐處理器整合（多個 SDK / API）： 針對每個付款處理器單獨實作。這會增加處理器特定程式碼和維護成本，相較於統一結構。
• 付款協調平台 / SaaS 連接器： 使用第三方協調抽象多個處理器。這些替代方案通常將複雜度轉移至平台，而非使用整合函式庫作為轉換層。
• 其他無狀態連接器函式庫或中介層： 選擇標準化跨提供者的付款請求的中介軟體。差異在於金鑰庫/代幣化處理方式、是否保持狀態，以及連接器涵蓋/測試管理。
• 直接使用 Hyperswitch 連接器邏輯（無 Prism 提取）： 若已在 Hyperswitch 環境中運作，可依賴更廣泛的平台元件，而非採用 Prism 作為獨立統一函式庫。