Rivya AI दस्तावेज़

Rivya Payment Checkout गाइड

Rivya plan और credit-pack checkout, Stripe redirects, /payment bridge, webhooks, billing updates और purchase checks को समझें.

अंतिम समीक्षा 2026/04/28 को

Rivya में plan या credit pack खरीदने के बाद क्या होता है, यह समझने के लिए इस payment checkout guide का उपयोग करें.

Rivya में payment को लेकर लोग आमतौर पर यह गलत समझते हैं:

Stripe पर payment complete होना last step नहीं है. Product को अभी catch up करना और उस change को सही तरह reflect करना होता है.

इसीलिए checkout flow Stripe पर खत्म नहीं होता, और browser वापस आते ही भी खत्म नहीं होता.

Payment Flow के तीन Real Stages हैं

अभी checkout को समझना आसान है अगर आप इसे तीन stages में तोड़ें:

  1. Rivya checkout session create करता है
  2. user Stripe Checkout complete करता है
  3. Rivya product state को फिर से trustworthy बनने का wait करता है

वह third stage ही कारण है कि /payment मौजूद है.

Checkout कहां से Start हो सकता है

Checkout अभी उन जगहों से start होता है जो user intent से already match करती हैं:

  • Pricing
  • /settings/billing
  • /settings/credits

और दो main purchase shapes हैं:

  • subscription plan checkout
  • one-time credit-pack checkout

ये अलग commercial decisions हैं, लेकिन same confirmation path में converge करते हैं.

Plan Checkout और Credit-Pack Checkout Similar हैं, लेकिन Same नहीं

Plan checkout subscription-shaped है.

Credit-pack checkout one-time wallet top-up जैसा shaped है.

यह difference इसलिए matter करता है क्योंकि payment के बाद Rivya को जानना होता है कि उसे क्या refresh करना चाहिए:

  • subscription state
  • या wallet state

इसीलिए same Stripe success moment आपको बाद में different product surfaces पर वापस भेज सकता है.

/payment आखिर क्यों Exists करता है

/payment usual sense में receipt page नहीं है.

यह processing bridge है.

इसका job है:

  • Stripe session_id read करना
  • check करना कि product-side payment record settled है या नहीं
  • जरूरत हो तो थोड़े समय तक polling करते रहना
  • और तभी आपको app के right part में वापस redirect करना

यह content page से ज्यादा state-synchronization page जैसा है.

Product Perspective से Payment “Really Done” कब है?

User के point of view से payment तब complete लगता है जब Stripe कहता है कि वह काम कर गया.

Product के point of view से payment तभी really complete है जब account state Rivya में visibly updated हो.

आमतौर पर इसका मतलब है:

  • payment record paid या completed के रूप में marked है
  • subscription या wallet effects visible हैं
  • आप stale state देखे बिना billing या credits में safely return कर सकते हैं

यही real reason है कि product user को तुरंत app में वापस फेंकने के बजाय /payment पर wait करता है.

/payment Poll करता है फिर भी Webhooks क्यों Matter करते हैं

/payment Stripe webhooks को replace नहीं करता.

Durable backend state update करने वाले webhooks ही हैं.

/payment page इसलिए exists करता है ताकि experience redirect करने से पहले wait कर सके, जब तक वह state trust करने लायक reflect न हो जाए.

यह difference है:

  • “Stripe ने कुछ process किया”
  • और “Rivya अब उस change को clearly reflect करता है”

Payment के बाद आप कहां जाते हैं

Return path intentionally उस चीज से tied है जो बदली है.

अगर purchase subscription-related था, तो आपको generally billing की ओर भेजा जाता है.

अगर purchase credit pack था, तो आपको generally credits की ओर भेजा जाता है.

यह cosmetic routing नहीं है. यह उस question से match करता है जो users payment के तुरंत बाद पूछते हैं:

  • क्या मेरा plan update हुआ?
  • या मेरा wallet update हुआ?

Timeout या Failure वास्तव में क्या मतलब रखता है

अगर /payment timeout या fail होता है, तो इसका automatically मतलब यह नहीं कि payment itself disappeared.

अक्सर इसका मतलब इनमें से एक होता है:

  • product-side payment record अभी settled नहीं हुआ
  • redirect उस state पर wait कर रहा है जो अभी catch up कर रही है
  • user को बहुत जल्दी redirect किया गया तो account page अभी stale दिखेगा

इसीलिए timeout state fake success state से बेहतर है. यह user को बताता है कि product confirmation वाला part अभी incomplete है.

Payment Really Landed है या नहीं Check करने का Best Way

Checkout के बाद cleanest verification path है:

  1. /payment को अपना flow finish करने दें
  2. purchase plan था तो /settings/billing check करें
  3. purchase pack था तो /settings/credits check करें
  4. account अभी भी out of sync लगे तो Notifications Center check करें

यह random pages refresh करके guess करने से आमतौर पर बेहतर है.

Payment Account Memory भी बनता है

Payment सिर्फ checkout action नहीं है. यह account history का हिस्सा भी बनता है, durable events के जरिए जैसे:

  • subscription started
  • subscription renewed
  • payment failed
  • credit package added

इसीलिए notifications भी यहां matter करते हैं. Stripe tab बंद करना account story का end नहीं है.

Better Mental Model

Rivya checkout को समझने का simplest way है:

  • Stripe money movement handle करता है
  • /payment product-side re-entry handle करता है

अगर आप इन दोनों roles को अलग रखते हैं, तो पूरा flow reason करना आसान हो जाता है.

Checkout State Checklist

जब कोई purchase unfinished या confusing लगे, check करें:

  • Confirm करें कि Checkout कहां start हुआ: public pricing, billing settings या credits settings.
  • Check करें कि Stripe ने payment complete किया और user को /payment पर return किया.
  • दूसरा paid task start करने से पहले Rivya को subscription, pack, invoice और wallet state refresh करने दें.
  • Subscriptions के लिए billing pages और packs या wallet history के लिए credits pages इस्तेमाल करें.
  • Browser redirect को proof न मानें कि webhook और account state already settled हैं.

Payment Retry करने से पहले Recheck करें

अगर user stale plan, missing credits, duplicate Checkout windows, failed payment या successful Stripe receipt देखता है जो अभी Rivya में reflected नहीं है, तो retry करने से पहले recheck करें.

विषय-सूची