Как подключить Stripe и принимать оплату

Stripe в RentProg пополняет баланс клиента банковской картой. Сотрудник создаёт ссылку на оплату, клиент платит на странице Stripe, и после подтверждения от Stripe сумма сама зачисляется на баланс клиента. Платёж идёт в основной валюте филиала.

Кому доступно

Действие	Кто
Открыть панель «Stripe»	Компании, у которых Stripe входит в тариф; на пробном периоде панель открыта
Задать или удалить секретный ключ и секрет вебхука, сохранить настройки	Менеджер и выше
Создать ссылку на оплату, отправить её клиенту	Сотрудники компании; партнёрам, агентам и гостям недоступно
Подтвердить возврат через интерфейс	Пользователи с ролями «Менеджер», «Управляющий филиалом» и «Главный администратор»

Ограничения по стране у Stripe нет.

Что подготовить в Stripe

• публикуемый ключ — начинается с pk_test_ или pk_live_;
• секретный ключ — начинается с sk_test_ или sk_live_;
• секрет подписи вебхука — начинается с whsec_;
• две страницы вашего сайта: куда вернуть клиента после оплаты и после отказа от неё.

Как подключить Stripe

1. Откройте профиль компании, вкладка «Интеграции».
2. Раскройте панель «Stripe».
3. Включите «Включить Stripe».
4. Впишите ключи из кабинета Stripe в поля Publishable Key, Secret Key и Webhook Secret.
5. Укажите «URL успешного возврата» и «URL отмены».
6. Нажмите «Сохранить».

Пока переключатель включён, настройки не сохранятся без всех пяти значений: система предупредит, что Stripe не настроен.

Секретный ключ и секрет вебхука после сохранения не показываются. В поле видна подсказка «Задан — оставьте пустым, чтобы не менять». Чтобы стереть ключ, нажмите «Удалить ключ» и подтвердите: интеграция перестанет работать до ввода нового.

Важно

Без секрета вебхука RentProg не принимает сообщения Stripe об оплате, и баланс клиента не пополнится, даже если деньги списаны. В кабинете Stripe нужна точка приёма событий, которая ведёт на адрес /api/v1/integrations/stripe_payments/webhook сервера RentProg; её секрет и вписывается в Webhook Secret.

RentProg обрабатывает события checkout.session.completed, payment_intent.succeeded, payment_intent.payment_failed, payment_intent.canceled, charge.succeeded, charge.updated, charge.failed, charge.refunded и события споров charge.dispute.*.

Как выставить ссылку на оплату

1. Откройте карточку клиента и нажмите значок с подсказкой «Пополнить через Stripe».
2. Укажите «Сумма» и при желании «Описание (необязательно)».
3. Нажмите «Создать платеж».
4. Отправьте ссылку клиенту кнопкой «Отправить на Email» или «Отправить в мессенджеры», либо покажите ему QR-код из того же окна.

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

Кнопка «Отправить в мессенджеры» отправляет ссылку через подключённый WhatsApp, MAX или Telegram. Если ни один мессенджер не подключён, откроется WhatsApp с готовым сообщением. Для отправки нужен телефон клиента, для письма — email.

Подсказка

Клиент может пополнить баланс и сам, из личного кабинета: когда Stripe настроен, кабинет предлагает оплату картой.

Что происходит после оплаты

Когда Stripe подтверждает платёж, RentProg проводит операцию «Пополнение баланса клиента» безналичным способом и увеличивает баланс клиента. Зачисление по одному платежу проводится ровно один раз, даже если Stripe пришлёт подтверждение повторно.

Все платежи клиента видны в его карточке, в таблице «Платежи Stripe».

Статус	Что значит
Заказ создан	Платёж заведён, ссылки ещё нет
Ожидание подтверждения платежа	Ссылка выдана, оплаты ещё нет
Платеж успешен	Деньги получены и зачислены на баланс
Платеж неуспешен	Оплата не прошла или ссылку не удалось получить
Платеж отменен	Платёж отменён в Stripe
Частично возвращен	Клиенту вернули часть суммы
Возвращен	Клиенту вернули всю сумму

Как сделать возврат

1. Откройте карточку клиента и найдите таблицу «Платежи Stripe».
2. Нажмите «Возврат» у успешного платежа.
3. Укажите «Сумма возврата» — полную или частичную, не больше суммы «Доступно для возврата».
4. Нажмите «Подтвердить возврат».

Важно

Деньги возвращаются на карту клиента, операция необратима. Баланс клиента уменьшится, когда Stripe подтвердит возврат. Пока предыдущий возврат по этому платежу не завершён, новый не принимается.

Возврат, сделанный прямо в кабинете Stripe, RentProg тоже учтёт, если получит о нём событие.