Посібник Rivya з оформлення платежів

Використовуйте цей посібник з оформлення оплати, коли потрібно зрозуміти, що відбувається після купівлі плану або пакета кредитів у Rivya.

Люди зазвичай неправильно розуміють оплату в Rivya ось так:

Завершення платежу в Stripe не є останнім кроком. Продукт ще має наздогнати зміну й коректно її відобразити.

Саме тому оформлення платежу не завершується у Stripe або в ту мить, коли браузер повертається до Rivya.

Потік оплати має три реальні етапи

Процес оплати легше зрозуміти, якщо розділити його на три етапи:

1. Rivya створює платіжний сеанс

2. користувач завершує Stripe Checkout

3. Rivya чекає, доки стан продукту знову стане надійним

Саме цей третій етап пояснює, навіщо існує /payment.

Де може початися оформлення платежу

Оформлення платежу починається там, де вже зрозумілий намір користувача:

• Pricing

• /settings/billing

• /settings/credits

І дві основні форми покупки:

• оплата плану підписки

• оплата одноразового пакета кредитів

Це різні комерційні рішення, але вони все одно сходяться в той самий шлях підтвердження.

Оплата плану й пакета кредитів схожі, але не однакові

Оплата плану оформлюється як підписка.

Оплата пакета кредитів оформлюється як одноразове поповнення гаманця.

Ця різниця важлива, бо після оплати Rivya має знати, що саме потрібно оновити:

• стан підписки

• або стан гаманця

Саме тому та сама подія успішної оплати Stripe може потім повернути вас до різних розділів продукту.

Навіщо взагалі існує /payment

/payment не є сторінкою квитанції у звичному сенсі.

Це міст обробки.

Його задача:

• прочитати Stripe session_id

• перевірити, чи запис платежу на боці продукту став остаточним

• за потреби короткий час продовжувати опитування

• лише після цього перенаправити вас назад у правильну частину застосунку

Це робить його більше сторінкою синхронізації стану, ніж контентною сторінкою.

Коли платіж "справді завершено" з погляду продукту?

З погляду користувача платіж здається завершеним, щойно Stripe каже, що все спрацювало.

З погляду продукту платіж справді завершений лише тоді, коли стан акаунта видимо оновлено в Rivya.

Зазвичай це означає:

• запис платежу має стан paid або completed

• ефекти підписки або гаманця видимі

• можна безпечно повернутися до білінгу або кредитів, не побачивши застарілий стан

Це справжня причина, чому продукт чекає на /payment, а не одразу викидає користувача назад у застосунок.

Чому вебхуки важливі, навіть коли /payment опитує стан

/payment не замінює вебхуки Stripe.

Вебхуки й надалі оновлюють збережений стан серверної частини.

Сторінка /payment існує, щоб досвід міг зачекати, доки цей стан відобразиться достатньо добре для довіри перед перенаправленням.

Це різниця між:

• "Stripe щось обробив"

• і "Rivya тепер чітко відображає цю зміну"

Куди ви потрапляєте після оплати

Шлях повернення навмисно прив'язаний до того, що змінилося.

Якщо покупка пов'язана з підпискою, вас зазвичай повертають у бік білінгу.

Якщо покупка була пакетом кредитів, вас зазвичай повертають у бік кредитів.

Це не косметична маршрутизація. Вона відповідає питанню, яке користувачі зазвичай мають одразу після оплати:

• чи оновився мій план?

• чи оновився мій гаманець?

Що насправді означає тайм-аут або помилка

Якщо /payment завершується тайм-аутом або помилкою, це не означає автоматично, що сам платіж зник.

Частіше це означає одне з такого:

• запис платежу на боці продукту ще не став остаточним

• перенаправлення чекає на стан, який усе ще наздоганяє

• сторінка акаунта все ще виглядала б застарілою, якби користувача перенаправили надто рано

Саме тому стан тайм-ауту кращий за хибне повідомлення про успіх: він чесно показує, що Rivya ще не завершила підтвердження.

Найкращий спосіб перевірити, чи платіж справді дійшов

Після оплати найнадійніший шлях перевірки такий:

1. дайте /payment завершити свій потік

2. перевірте /settings/billing, якщо покупка була планом

3. перевірте /settings/credits, якщо покупка була пакетом

4. перевірте посібник Rivya з центру сповіщень, якщо акаунт усе ще виглядає не синхронізованим

Зазвичай це краще, ніж оновлювати випадкові сторінки й здогадуватися.

Оплата також стає пам'яттю акаунта

Оплата — це не лише момент оформлення платежу. Вона також стає частиною історії акаунта через збережені події, як-от:

• підписку розпочато

• підписку поновлено

• платіж не вдався

• пакет кредитів додано

Саме тому сповіщення тут теж важливі. Закриття вкладки Stripe не є кінцем історії акаунта.

Краща ментальна модель

Найпростіше уявляти оформлення платежу в Rivya так:

• Stripe обробляє рух грошей

• /payment обробляє повернення на бік продукту

Якщо тримати ці дві ролі окремо, весь потік стає легше зрозуміти.

Читати далі

• Посібник Rivya з кредитів і оплати

• Плани й пакети Rivya

• Посібник Rivya з центру сповіщень

• Усунення несправностей у Rivya

Контрольний список стану платежу

Коли покупка виглядає незавершеною або заплутаною, перевірте:

• Перевірте, де почалася оплата: на публічній сторінці цін, у налаштуваннях оплати чи в налаштуваннях кредитів.

• Перевірте, чи Stripe завершив платіж і повернув користувача на /payment.

• Зачекайте, доки Rivya оновить стан підписки, пакета, інвойсу й гаманця, перш ніж починати іншу платну задачу.

• Використовуйте сторінки білінгу для підписок і сторінки кредитів для пакетів або історії гаманця.

• Не сприймайте перенаправлення браузера як доказ того, що вебхук уже спрацював, а стан акаунта остаточно зафіксовано.

Повторно перевірте перед повторною оплатою

Перед повторною спробою оплати перевірте стан ще раз, якщо користувач бачить застарілий план, відсутні кредити, кілька відкритих вікон Stripe Checkout, невдалий платіж або успішну квитанцію Stripe, яка ще не відображається в Rivya.