Подключите Stripe к приложению MonstarX

Оплата картой, подписки и страница оформления заказа в вашем приложении.

Тип

Для вашего приложения

Категория

Платежи и подписки

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

Ключ API

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

Что можно с этим создать?

• Кнопку «Купить», которая открывает страницу оплаты Stripe и возвращает покупателя в приложение после оплаты.
• Абонементы и наборы, например «5 занятий за $90», которые после оплаты открывают доступ к чему-то в приложении.
• Ежемесячные или годовые подписки для участников или на платный тариф.
• Историю заказов для каждого покупателя и страницу администратора со списком платежей.
• Автоматические действия после оплаты: например, отметить заказ оплаченным и отправить чек на почту, когда Stripe подтвердит платёж.

Что понадобится

• Аккаунт Stripe. Он создаётся бесплатно, а Stripe берёт комиссию с каждого успешного платежа (см. цены Stripe). MonstarX ничего не добавляет сверху.
• Для тестов больше ничего не нужно: в любом аккаунте Stripe есть песочница (sandbox) — тренировочная копия аккаунта, где настоящие деньги не двигаются.
• Для настоящих платежей Stripe сначала попросит активировать аккаунт: указать данные о бизнесе и банковский счёт для выплат.

Что такое тестовый и рабочий режимы?

Stripe выдаёт два набора ключей, и в поле Режим MonstarX спрашивает, какой из них вы вставляете:

Режим	Ключи начинаются с	Что происходит
Тестовый режим (тестовые ключи)	sk_test_… и pk_test_…	Пробные платежи по тестовым номерам карт. С настоящих карт ничего не списывается, деньги не двигаются. Используйте, пока создаёте приложение.
Рабочий режим (рабочие ключи)	sk_live_… и pk_live_…	Настоящие карты и настоящие деньги, которые перечисляются на ваш банковский счёт. Используйте, когда платят настоящие клиенты.

То, что создано в одном режиме, не существует в другом: товары, цены, покупатели и платежи из песочницы остаются в песочнице.

Как оплатить тестовой картой?

В песочнице страница оплаты Stripe принимает опубликованные тестовые карты Stripe. Укажите любой срок действия в будущем (например, 12/34), любой трёхзначный CVC и любой почтовый индекс:

Номер карты	Что произойдёт
4242 4242 4242 4242	Платёж пройдёт успешно.
4000 0000 0000 0002	Карта будет отклонена — так вы увидите, что видят покупатели, когда платёж не проходит.
4000 0025 0000 3155	Банк запросит дополнительную проверку (3D Secure), прежде чем провести платёж.

Никогда не вводите номер настоящей карты на тестовой странице оплаты. Другие тестовые карты Stripe перечисляет в руководстве по тестированию.

Получите ключи

1. Войдите в панель Stripe.

2. Для тестов откройте песочницу (sandbox) в меню аккаунта слева вверху. Для настоящих платежей вместо этого переключитесь в live mode.

3. Откройте API keys (в разделе Developers). Скопируйте Publishable key, затем откройте и скопируйте Secret key.

Осторожно

Секретный ключ позволяет списывать деньги и оформлять возвраты в вашем аккаунте. Вставляйте его только в форму подключения в MonstarX — никогда в чат, письмо или код приложения. Рабочий секретный ключ Stripe показывает только один раз, поэтому сохраните его в надёжном месте.

Подключите ключи в MonstarX

Когда вы просите добавить оплату, MonstarX обычно показывает в чате карточку Подключить Stripe с теми же полями. Можно подключить Stripe и самостоятельно:

1. Откройте проект, нажмите Облачные сервисы на верхней панели, затем Облако.

2. В разделе Подключения нажмите Подключить рядом с Stripe.

3. В поле Режим выберите Тестовый режим (тестовые ключи) или Рабочий режим (рабочие ключи).

4. Вставьте ключи в поля Секретный ключ и Публикуемый ключ. Поле Секрет подписи вебхука пока оставьте пустым.

   

5. Нажмите Подключить Stripe. В строке появится Подключено · тестовый режим (или Подключено · рабочий режим), и предпросмотр перезапустится уже с ключами.

MonstarX не проверяет, подходят ли ключи к выбранному режиму, поэтому следите сами: ключи sk_test_ вставляйте, когда выбран Тестовый режим (тестовые ключи), а ключи sk_live_ — когда выбран Рабочий режим (рабочие ключи).

Нужен ли секрет подписи вебхука?

Вебхук — это сообщение от Stripe приложению: «этот платёж прошёл», даже если покупатель закрыл страницу, не вернувшись в приложение. Он нужен приложениям, которые после оплаты открывают доступ к чему-то или работают с подписками. Добавьте его после публикации приложения: до закрытого предпросмотра Stripe достучаться не может.

1. Спросите MonstarX: «Какой адрес у моего вебхука Stripe и какие события он должен получать?» Обычно это https://your-app.monstarx.app/api/stripe-webhook.

2. В Stripe откройте Webhooks, нажмите Create an event destination, выберите эти события, затем Webhook endpoint и вставьте адрес.

3. Откройте signing secret (он начинается с whsec_) и скопируйте его.

4. В MonstarX нажмите Обновить ключи в строке Stripe, вставьте секрет в поле Секрет подписи вебхука и нажмите Сохранить ключи. Опубликуйте приложение заново, чтобы рабочая версия получила секрет.

У тестового и рабочего режимов свои вебхуки и свои секреты подписи.

Как попросить MonstarX

Вы пишете	Что происходит
«Пусть участники покупают абонемент на 5 занятий за $90 через Stripe.»	Кнопка покупки, страница оплаты Stripe на эту сумму и страница благодарности; после оплаты абонемент начисляется.
«Добавь ежемесячный тариф Pro за $12 через Stripe и страницу, где видно мой тариф.»	Оформление подписки и страница с тарифом участника.
«Добавь страницу администратора со списком всех платежей.»	Страница со списком платежей: кто заплатил, за что и когда.
«Импортируй мои товары из Stripe в магазин.»	Чтобы прочитать ваш аккаунт, MonstarX нужны ключи, поэтому в карточке написано Чтобы продолжить, MonstarX нужен Stripe. Как только вы подключите Stripe, MonstarX продолжит сам.

Ключей пока нет? Нажмите Позже в карточке. MonstarX всё равно создаст оформление оплаты целиком, а кнопка будет сообщать, что Stripe ещё не подключён, пока вы не добавите ключи.

Переход на настоящие платежи

1. Активируйте аккаунт Stripe, переключитесь в live mode и скопируйте рабочие ключи.

2. В разделе Облачные сервисы›Облако нажмите Обновить ключи в строке Stripe.

3. В поле Режим выберите Рабочий режим (рабочие ключи), вставьте оба рабочих ключа (и рабочий секрет подписи вебхука, если он у вас есть) и нажмите Сохранить ключи.

4. Опубликуйте приложение заново. С этого момента платежи настоящие.

Совет

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

Безопасность и конфиденциальность

• Ключи хранятся в зашифрованном виде только вместе с этим приложением. Их названия видны в разделе Облачные сервисы›Секреты, а значения больше никогда не показываются.
• Секретный ключ и секрет подписи вебхука использует только сервер приложения. Публикуемый ключ специально рассчитан на то, чтобы его видели в браузере, — это безопасно.
• Номера карт вводятся на собственной странице оплаты Stripe. Они никогда не попадают ни в приложение, ни в MonstarX.
• Подключить, обновить или отключить Stripe может только владелец проекта. Кнопка Отключить удаляет ключи из этого приложения, и после этого на странице оплаты появляется сообщение, что Stripe не подключён.
• Если ключ утёк, выпустите новый (roll key) в панели Stripe и вставьте его через Обновить ключи.

Полезно знать

• Одно приложение работает только в одном режиме Stripe. Если вернуть рабочее приложение на тестовые ключи, настоящие платежи прекратятся, пока вы не переключитесь обратно.
• В Stripe есть ещё ограниченные ключи (restricted keys, rk_…) — только с теми правами, которые вы выберете. Они подходят для поля Секретный ключ, если разрешают всё, что делает приложение, например создавать сеансы оплаты (checkout sessions).
• QA-тестирование проверяет сценарий оплаты до шага Stripe и, пока Stripe не подключён, отмечает, что для него нужны ключи.

Вопросы и ответы

Берёт ли MonstarX процент с моих продаж?

Нет. Платежи поступают прямо на ваш аккаунт Stripe. Действуют только комиссии самого Stripe.

Можно ли проверить оплату без настоящей карты?

Да. При подключении Stripe выберите Тестовый режим (тестовые ключи) и заплатите тестовой картой 4242 4242 4242 4242 с любой будущей датой и любым CVC. Деньги не двигаются.

Как перейти с тестовых платежей на настоящие?

Нажмите Обновить ключи в строке Stripe, в поле Режим выберите Рабочий режим (рабочие ключи), вставьте рабочие ключи, нажмите Сохранить ключи и опубликуйте приложение заново.

Почему на странице оплаты написано, что Stripe не подключён?

Ключи ещё не добавлены или были удалены. Откройте Облачные сервисы → Облако и подключите Stripe — предпросмотр перезапустится уже с ключами.

Можно ли смотреть платежи в MonstarX?

В приложении видно то, что для него создал MonstarX, например страницу заказов. Полная история всех платежей, возвратов и выплат — в панели Stripe.

Читайте также

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

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

TwilioОтправляйте клиентам чек или напоминание по SMS.

Храните ключи API в разделе «Секреты»Где хранятся ваши ключи.