Платежи Stripe

1Что это даёт вашему приложению#

Позволяет созданным вами приложениям принимать реальные деньги — платный доступ, обновления до «Pro», кнопки покупки — через Stripe Checkout.

Это ВАШ аккаунт Stripe: ваши ключи, ваши деньги, платежи идут прямо вам. AppMint не берёт комиссию и не несёт ответственности за платежи (без Stripe Connect). Вы подключаете Stripe ОДИН раз в настройках; каждое создаваемое приложение использует его снова — вы лишь описываете, что продавать, и не вводите ключи заново.

ИИ пишет весь платёжный код. Ваш секретный ключ никогда не попадает в приложение — он хранится в вашем бэкенде Supabase.

2Сначала подключите Supabase (обязательно)#

Для платежей Stripe нужен защищённый сервер, на котором хранится ваш секретный ключ и подтверждаются платежи, — это ваш проект Supabase. Поэтому сначала подключите и включите Supabase (Настройки → BACKEND - SUPABASE) — глава «🗄️ Бэкенд Supabase (подключите один раз)» в начале этого руководства расскажет, как это сделать.

Если Supabase не активен, вы увидите «Ключи Stripe сохранены, но для платежей также нужен активный Supabase». AppMint автоматически отправляет ваш секрет Stripe в ваши функции Supabase при развёртывании — в созданное приложение он никогда не попадает.

3Получите ключи Stripe (начните с тестового режима)#

На компьютере:

1. Откройте панель Stripe и оставайтесь в тестовом режиме / песочнице, пока разрабатываете (теперь Stripe называет тестовую среду «песочницей»; в старых аккаунтах есть переключатель Test/Live). Реальные платежи здесь не проводятся.
2. Перейдите в Developers → API keys.
3. Скопируйте «Publishable key» (начинается с pk_test_…), а также откройте и скопируйте «Secret key» (начинается с sk_test_…).

Используйте стандартный секретный ключ (sk_…), а не ограниченный (rk_…) — AppMint проверяет и отправляет секрет sk_. Одобрение продавца не требуется, чтобы создать и протестировать весь процесс до активации боевых платежей.

Открыть ключи API Stripe →

4Подключите Stripe в AppMint#

Откройте AI Studio → Настройки → прокрутите до «PAYMENTS - STRIPE (OPTIONAL)» → «CONNECT STRIPE (YOUR ACCOUNT)»:

1. Пока оставьте «Боевой режим» ВЫКЛЮЧЕННЫМ (выкл. = тестовый).
2. Вставьте публичный ключ (publishable key) в поле pk_test_….
3. Вставьте секретный ключ в поле sk_test_… (хранится в зашифрованном виде на этом устройстве).
4. Включите «Включить платежи Stripe для созданных приложений».
5. Нажмите «Проверить и сохранить ключи Stripe». AppMint проверит формат, убедится, что оба ключа относятся к одному режиму, и проверит секретный ключ в Stripe. После успеха вы увидите «● Подключено (TEST)».

5Что AppMint настраивает за вас#

Когда вы создаёте приложение с платежами, AppMint настраивает всё автоматически — вам не нужно заходить в панели Supabase или Stripe:

• Отправляет ваш STRIPE_SECRET_KEY в ваши Edge Functions в Supabase (в зашифрованном виде, только на стороне сервера).
• Разворачивает функцию «create-checkout» (запускает сессию Stripe Checkout) и функцию «stripe-webhook» (подтверждает платежи).
• Регистрирует вебхук в Stripe и сохраняет его секрет подписи.
• Создаёт таблицу «entitlements», чтобы приложение знало, кто заплатил.

Публичный ключ (pk_) — единственное значение Stripe, которое попадает в приложение, и его безопасно раскрывать.

6Опишите свой платный доступ — ИИ построит его#

Просто скажите, что вам нужно, простыми словами. ИИ добавит кнопку покупки, вызов оплаты и закроет платные функции:

• «Взимать $5 один раз за разблокировку темы Pro».
• «Подписка за $9 в месяц, убирающая рекламу».
• «Продавать загружаемый PDF за $19».

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

7Проверьте платёж от начала до конца#

В тестовом режиме реальные деньги не списываются. Пройдите весь процесс:

1. Откройте приложение и нажмите кнопку покупки/обновления.
2. На странице Stripe Checkout оплатите тестовой картой:

 4242 4242 4242 4242, any future expiry, any CVC, any ZIP.

1. Вы вернётесь в приложение, и платная функция откроется.
2. Откройте панель Stripe (тестовый режим) → Payments — вы увидите тестовый платёж.

Если доступ открылся, ваш вебхук и права доступа настроены правильно.

4242 4242 4242 4242   exp: any future date   CVC: any 3 digits

8Переходите на боевой режим, когда будете готовы#

1. Активируйте аккаунт Stripe для боевых платежей (панель Stripe → «Activate» / заполните данные о бизнесе).
2. В Stripe переключитесь из песочницы/тестового режима в боевой и скопируйте БОЕВЫЕ ключи (pk_live_… и sk_live_…) в Developers → API keys.
3. В AppMint → Настройки → Платежи: включите «Боевой режим», вставьте ключи pk_live_/sk_live_ и нажмите «Проверить и сохранить». Значок изменится на «● Подключено (LIVE)».
4. Пересоберите приложение.

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

9Если что-то не работает#

• «Ключи Stripe сохранены, но для платежей также нужен активный Supabase» → сначала включите Supabase (шаг 2).

• «Вы выбрали TEST, но ключи LIVE» (или наоборот) → переключатель режима должен соответствовать префиксу ваших ключей (pk_test/sk_test или pk_live/sk_live).

• «Stripe отклонил ключ» → секретный ключ неверен или отозван. Скопируйте его заново из Developers → API keys.

• Платёж прошёл, но функция остаётся заблокированной → вебхук не дошёл до Supabase. Пересоберите/разверните приложение заново, чтобы AppMint повторно зарегистрировал вебхук, и убедитесь, что проект Supabase приложения — тот, который вы подключили.

• Не удаётся активировать боевой аккаунт → Stripe НЕ подключает продавцов в некоторых странах (включая Индию). Тестовый режим работает везде, так что разрабатывать можно; для реальных платежей там понадобится страна, поддерживаемая Stripe, или другой провайдер.