Разберитесь с оформлением покупки для планов и пакетов кредитов Rivya, редиректами Stripe, мостом /payment, вебхуками, обновлениями биллинга и проверками покупки.

Используйте это руководство по оплате и оформлению покупки, когда нужно понять, что происходит после покупки плана или пакета кредитов в Rivya.

В платежах Rivya чаще всего неправильно понимают вот что:

завершение оплаты в Stripe - не последний шаг. Продукт еще должен догнать это изменение и корректно его отразить.

Именно поэтому оформление покупки не заканчивается на Stripe и не заканчивается в момент, когда браузер возвращается обратно.

У платежного потока есть три реальные стадии

Сейчас платежный поток проще понять, если разделить его на три стадии:

Rivya создает платежную сессию
пользователь завершает Stripe Checkout
Rivya ждет, пока состояние продукта снова станет надежным

Именно для третьей стадии существует /payment.

Откуда может начаться оформление покупки

Сейчас оформление покупки запускается из мест, которые уже соответствуют намерению пользователя:

страница цен
/settings/billing
/settings/credits

И есть две основные формы покупки:

оформление подписочного плана
оформление разового пакета кредитов

Это разные коммерческие решения, но они все равно сходятся в один путь подтверждения.

Оформление плана и пакета кредитов похоже, но не одинаково

Оформление плана устроено как подписка.

Оформление пакета кредитов устроено как разовое пополнение кошелька.

Эта разница важна, потому что после оплаты Rivya должна понять, что именно обновлять:

состояние подписки
или состояние кошелька

Поэтому один и тот же момент успешной оплаты в Stripe может затем вернуть вас в разные части продукта.

Зачем вообще существует `/payment`

/payment - это не страница квитанции в обычном смысле.

Это мост обработки.

Его задача:

прочитать Stripe session_id
проверить, что платежная запись на стороне продукта уже зафиксирована
при необходимости короткое время продолжать опрос
только затем перенаправить вас в правильную часть приложения

По смыслу это скорее страница синхронизации состояния, чем контентная страница.

Когда платеж “по-настоящему завершен” с точки зрения продукта

С точки зрения пользователя платеж кажется завершенным, когда Stripe сообщает об успехе.

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

Обычно это означает:

платежная запись отмечена как paid или completed
эффекты подписки или кошелька видны
можно безопасно вернуться в биллинг или кредиты и не увидеть устаревшее состояние

Это настоящая причина, по которой продукт ждет на /payment, а не сразу возвращает пользователя в приложение.

Почему вебхуки все еще важны, хотя `/payment` выполняет опрос

/payment не заменяет вебхуки Stripe.

Именно вебхуки по-прежнему обновляют устойчивое состояние бэкенда.

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

Это разница между:

“Stripe что-то обработал”
и “Rivya теперь явно отражает это изменение”

Куда вы попадаете после оплаты

Путь возврата намеренно связан с тем, что изменилось.

Если покупка была связана с подпиской, вас обычно отправляют обратно к биллингу.

Если покупка была пакетом кредитов, вас обычно отправляют обратно к кредитам.

Это не косметическая маршрутизация. Она соответствует вопросу, который обычно возникает у пользователя сразу после оплаты:

мой план обновился?
или мой кошелек обновился?

Что на самом деле означает тайм-аут или сбой

Если /payment уходит в тайм-аут или завершается ошибкой, это не означает автоматически, что сам платеж исчез.

Чаще это означает одно из следующего:

платежная запись на стороне продукта еще не зафиксировалась
редирект ждет состояние, которое все еще догоняет
страница аккаунта выглядела бы устаревшей, если бы пользователя перенаправили слишком рано

Поэтому состояние тайм-аута лучше, чем фальшивый успех. Оно сообщает пользователю, что неполной остается именно продуктовая проверка.

Лучший способ проверить, что платеж действительно применился

После оформления покупки самый чистый путь проверки такой:

дайте /payment завершить свой поток
проверьте /settings/billing, если покупка была планом
проверьте /settings/credits, если покупка была пакетом
проверьте центр уведомлений, если аккаунт все еще выглядит несинхронизированным

Обычно это лучше, чем обновлять случайные страницы и гадать.

Платеж также становится памятью аккаунта

Платеж - это не только действие оплаты. Он также становится частью истории аккаунта через постоянные события, например:

подписка началась
подписка продлена
платеж не прошел
пакет кредитов добавлен

Поэтому уведомления здесь тоже важны. Закрытие вкладки Stripe не завершает историю аккаунта.

Более удобная ментальная модель

Самый простой способ думать об оформлении покупки в Rivya:

Stripe обрабатывает движение денег
/payment обрабатывает возвращение в продукт

Если держать эти две роли отдельно, весь поток становится проще понимать.

Чеклист состояния оплаты

Когда покупка выглядит незавершенной или запутанной, проверьте:

Подтвердите, откуда началось оформление покупки: публичная страница цен, настройки биллинга или настройки кредитов.
Проверьте, завершил ли Stripe платеж и вернул ли пользователя на /payment.
Дождитесь, пока Rivya обновит подписку, пакет, счет и состояние кошелька, прежде чем запускать другую платную задачу.
Используйте страницы биллинга для подписок, а страницы кредитов - для пакетов или истории кошелька.
Не считайте браузерный редирект доказательством, что вебхуки и состояние аккаунта уже зафиксировались.

Повторно проверьте перед новой попыткой оплаты

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

Руководство Rivya по оплате и оформлению покупки