Docs Rivya AI

Panduan Payment Checkout Rivya

Fahami checkout plan dan credit-pack Rivya, redirect Stripe, bridge /payment, webhooks, kemas kini billing, dan semakan pembelian.

Terakhir disemak pada 2026/04/28

Gunakan panduan payment checkout ini apabila anda perlu memahami perkara yang berlaku selepas membeli plan atau credit pack dalam Rivya.

Perkara yang biasanya disalahfahami orang tentang payment dalam Rivya ialah ini:

Stripe melengkapkan payment bukan langkah terakhir. Produk masih perlu mengejar dan memaparkan perubahan itu dengan betul.

Itulah sebabnya aliran checkout tidak berakhir di Stripe, dan tidak berakhir sebaik sahaja browser kembali.

Aliran Payment Mempunyai Tiga Peringkat Sebenar

Buat masa ini, checkout lebih mudah difahami jika anda memecahkannya kepada tiga peringkat:

  1. Rivya mencipta checkout session
  2. pengguna melengkapkan Stripe Checkout
  3. Rivya menunggu product state menjadi boleh dipercayai semula

Peringkat ketiga itulah sebab sebenar /payment wujud.

Tempat Checkout Boleh Bermula

Checkout pada masa ini bermula dari tempat yang sudah sepadan dengan niat pengguna:

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

Dan dua bentuk pembelian utama ialah:

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

Itu keputusan komersial yang berbeza, tetapi masih bertemu dalam laluan confirmation yang sama.

Plan Checkout Dan Credit-Pack Checkout Serupa, Tetapi Tidak Sama

Plan checkout berbentuk subscription.

Credit-pack checkout berbentuk top-up wallet sekali.

Perbezaan itu penting kerana selepas payment, Rivya perlu tahu sama ada ia patut menyegarkan:

  • subscription state
  • atau wallet state

Itulah sebabnya momen kejayaan Stripe yang sama masih boleh menghantar anda kembali ke permukaan produk yang berbeza selepas itu.

Mengapa /payment Wujud

/payment bukan receipt page dalam maksud biasa.

Ia ialah processing bridge.

Tugasnya ialah:

  • membaca Stripe session_id
  • menyemak sama ada rekod payment sisi produk sudah settled
  • terus polling untuk tempoh pendek jika perlu
  • hanya selepas itu redirect anda kembali ke bahagian app yang betul

Itu menjadikannya lebih seperti halaman state-synchronization daripada halaman content.

Bila Payment “Benar-Benar Selesai” Dari Perspektif Produk?

Dari sudut pengguna, payment terasa selesai apabila Stripe berkata ia berjaya.

Dari sudut produk, payment hanya benar-benar selesai apabila account state kelihatan dikemas kini dalam Rivya.

Itu biasanya bermaksud:

  • rekod payment ditandakan sebagai paid atau completed
  • kesan subscription atau wallet kelihatan
  • anda boleh kembali ke billing atau credits dengan selamat tanpa melihat stale state

Inilah sebab sebenar produk menunggu pada /payment dan bukannya terus melemparkan pengguna kembali ke app.

Mengapa Webhooks Masih Penting Walaupun /payment Polls

/payment tidak menggantikan Stripe webhooks.

Webhooks masih perkara yang mengemas kini durable backend state.

Halaman /payment wujud supaya pengalaman boleh menunggu sehingga state itu tercermin dengan cukup baik untuk dipercayai sebelum redirect.

Itulah perbezaan antara:

  • “Stripe memproses sesuatu”
  • dan “Rivya kini jelas memaparkan perubahan itu”

Ke Mana Anda Pergi Selepas Payment

Return path sengaja diikat pada perkara yang berubah.

Jika pembelian berkaitan subscription, anda secara umum dihantar kembali ke arah billing.

Jika pembelian ialah credit pack, anda secara umum dihantar kembali ke arah credits.

Itu bukan routing kosmetik. Ia sepadan dengan soalan yang biasanya dimiliki pengguna selepas membayar:

  • adakah plan saya dikemas kini?
  • atau adakah wallet saya dikemas kini?

Maksud Sebenar Timeout Atau Failure

Jika /payment timeout atau gagal, itu tidak secara automatik bermaksud payment itu sendiri hilang.

Lebih kerap, ia bermaksud salah satu daripada ini:

  • rekod payment sisi produk belum settled lagi
  • redirect sedang menunggu state yang masih mengejar
  • halaman akaun masih akan kelihatan stale jika pengguna diredirect terlalu awal

Itulah sebabnya timeout state lebih baik daripada fake success state. Ia memberitahu pengguna bahawa product confirmation ialah bahagian yang masih belum lengkap.

Cara Terbaik Menyemak Sama Ada Payment Benar-Benar Masuk

Selepas checkout, laluan verification paling bersih ialah:

  1. biarkan /payment menyelesaikan alirannya
  2. semak /settings/billing jika pembelian ialah plan
  3. semak /settings/credits jika pembelian ialah pack
  4. semak Pusat Notifikasi jika akaun masih kelihatan tidak selaras

Ini biasanya lebih baik daripada menyegarkan halaman rawak dan meneka.

Payment Juga Menjadi Memori Akaun

Payment bukan hanya tindakan checkout. Ia juga menjadi sebahagian daripada history akaun melalui event tahan lama seperti:

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

Itulah sebabnya notifications penting di sini juga. Menutup tab Stripe bukan penghujung cerita akaun.

Mental Model Yang Lebih Baik

Cara paling mudah memikirkan checkout Rivya ialah:

  • Stripe mengendalikan pergerakan wang
  • /payment mengendalikan re-entry sisi produk

Jika anda memisahkan dua peranan itu, keseluruhan aliran menjadi lebih mudah difahami.

Baca Seterusnya

Senarai Semak Checkout State

Apabila pembelian kelihatan belum selesai atau mengelirukan, semak:

  • Sahkan tempat Checkout bermula: public pricing, billing settings, atau credits settings.
  • Semak sama ada Stripe melengkapkan payment dan mengembalikan pengguna ke /payment.
  • Tunggu Rivya menyegarkan subscription, pack, invoice, dan wallet state sebelum memulakan tugas berbayar lain.
  • Gunakan halaman billing untuk subscriptions dan halaman credits untuk packs atau wallet history.
  • Jangan anggap browser redirect sebagai bukti bahawa webhook dan account state sudah settled.

Semak Semula Sebelum Mencuba Payment Lagi

Semak semula sebelum mencuba lagi jika pengguna melihat stale plan, credits hilang, duplicate Checkout windows, failed payment, atau receipt Stripe yang berjaya tetapi belum tercermin dalam Rivya.

Jadual kandungan