Rivya 付款結帳指南

當你需要了解在 Rivya 購買方案或點數包後會發生什麼時，請使用這份付款結帳指南。

使用者經常誤解 Rivya 付款流程的一點是：

Stripe 完成付款不是最後一步。產品仍然必須跟上，並正確反映那個變更。

因此，結帳流程不會在 Stripe 完成付款時結束，也不會在瀏覽器返回 Rivya 的那一刻結束。

付款流程有三個實際階段

目前，把結帳拆成三個階段最容易理解：

1. Rivya 建立 Checkout Session

2. 使用者完成 Stripe Checkout

3. Rivya 等待產品狀態重新變得可信

第三個階段正是 /payment 存在的原因。

可以從哪裡開始結帳

結帳目前會從符合使用者意圖的位置開始：

• 價格方案

• /settings/billing

• /settings/credits

兩種主要購買類型是：

• 訂閱方案結帳

• 一次性點數包結帳

這是不同的商業決策，但仍會匯入同一個確認路徑。

方案結帳與點數包結帳相似但不相同

方案結帳會建立或更新訂閱。

點數包結帳則是一次性為錢包增加點數。

這個差異很重要，因為付款後 Rivya 需要知道應該更新：

• 訂閱狀態

• 或錢包狀態

因此，同一個 Stripe 成功事件之後，仍可能把你送回不同的產品區域。

/payment 為什麼存在

/payment 不是一般意義上的收據頁面。

它是付款處理與產品狀態之間的銜接頁。

它的工作是：

• 讀取 Stripe 的 session_id

• 檢查產品端付款記錄是否已完成處理

• 如有需要，在短時間內持續輪詢

• 確認狀態後，才將你重新導向應用程式中的正確位置

因此，它更像狀態同步頁，而不是內容頁。

從產品角度看，付款何時才真正完成？

從使用者角度看，Stripe 說成功時，付款感覺已完成。

從產品角度看，只有帳戶狀態在 Rivya 中明確更新後，付款才真正完成。

這通常表示：

• 付款記錄已標記為 paid 或 completed

• 訂閱或錢包變更已經可見

• 你可以安全回到帳單或點數頁面，而不會看到過期狀態

這就是產品等待 /payment 完成，而不是立刻把使用者送回應用程式的真正原因。

為什麼 /payment 會輪詢，而 webhook 仍然重要

/payment 不會取代 Stripe webhook。

Webhook 仍然負責更新持久的後端狀態。

/payment 頁面的作用，是等到產品已充分反映該狀態且結果可信後，再進行重新導向。

這就是下列兩件事的差別：

• 「Stripe 已處理付款事件」

• 與「Rivya 現在已清楚反映該變更」

付款後你會去哪裡

回到哪裡，刻意與剛剛變更的內容綁定。

如果購買與訂閱相關，通常會送回帳單頁面。

如果購買的是點數包，通常會送回點數頁面。

這不只是頁面重新導向，而是對應使用者付款後通常會問的問題：

• 我的方案更新了嗎？

• 或我的錢包更新了嗎？

逾時或失敗實際代表什麼

如果 /payment 逾時或失敗，這不代表付款本身已經消失。

更常見的是下列其中一種：

• 產品端付款記錄尚未完成處理

• 重新導向正在等待狀態同步

• 如果過早重新導向，帳戶頁面可能仍顯示過期狀態

因此，顯示逾時狀態比顯示不實的成功狀態更可靠。它告訴使用者，尚未完成的可能是產品確認，而不一定是付款本身。

檢查付款是否真正完成的最佳方式

結帳後，最清楚的驗證方式是：

1. 讓 /payment 完成自己的流程

2. 如果購買的是方案，檢查 /settings/billing

3. 如果購買的是點數包，檢查 /settings/credits

4. 如果帳戶狀態看起來仍不同步，檢查通知中心

這通常比隨機刷新頁面並猜測更好。

付款也會成為帳戶記錄

付款不只是一次結帳動作，也會透過持久事件成為帳戶歷史的一部分，例如：

• 訂閱開始

• 訂閱續訂

• 付款失敗

• 點數包已加入

這也是通知在此很重要的原因。關閉 Stripe 分頁並不代表帳戶流程已經結束。

更好的理解方式

理解 Rivya 結帳流程最簡單的方式是：

• Stripe 處理款項移轉

• /payment 處理返回產品後的狀態銜接

把這兩個角色分開，整個流程就更容易推理。

接著閱讀

• Rivya 點數與計費

• Rivya 方案與點數包

• 通知中心

• Rivya 疑難排解

結帳狀態檢查清單

當購買看起來未完成或令人困惑時，請檢查：

• 確認結帳從哪裡開始：公開價格頁、帳單設定或點數設定。

• 檢查 Stripe 是否完成付款，並將使用者帶回 /payment。

• 在開始另一個付費任務前，等待 Rivya 更新訂閱、點數包、發票與錢包狀態。

• 使用帳單頁面處理訂閱，使用點數頁面處理點數包或錢包歷史。

• 不要把瀏覽器重新導向視為 webhook 與帳戶狀態已完成同步的證明。

重新嘗試付款前先檢查

如果使用者看到方案狀態過期、點數缺少、重複的 Checkout 視窗、付款失敗，或 Stripe 成功收據尚未反映到 Rivya，請在重試付款前重新檢查。