Stripe-оплата в AI-приложении через один коннектор

Чтобы принимать оплату через Stripe в приложении, собранном нейросетью, в Zugo достаточно одного коннектора: вставляете publishable- и secret-ключи, описываете словами, за что брать деньги, и билдер сам встраивает checkout в сгенерированный код. Сначала всё проверяется на тестовых ключах Stripe, а когда готовы принимать настоящие платежи, меняете их на боевые.

Вот и весь цикл. Не нужно читать документацию платёжного SDK и писать серверный код руками. Дальше разберём, что понадобится перед стартом, точные шаги, за что сгенерированное приложение может и не может брать деньги, и, честно, те части платного продукта, которые ни один AI-билдер за вас не сделает.

Что на самом деле делает коннектор Stripe?

Zugo это AI-билдер: вы описываете идею обычным языком, а он собирает рабочее приложение, лендинг, 2D-игру или многостраничную платформу с базой данных, авторизацией и платежами. Простое получается примерно за минуту, сложная платформа за несколько минут. Stripe это один из встроенных коннекторов, рядом с Supabase для базы и авторизации, Google Analytics, Resend для писем и Vercel для деплоя в ваш собственный аккаунт.

Когда Stripe подключён, сгенерированный код умеет создавать настоящие платёжные сценарии: страницу тарифов, кнопки которой открывают Stripe Checkout, пейволл перед премиум-контентом, кнопку «купить» на странице товара. Сам платёж проходит на хостед-чекауте Stripe, то есть данные карт вообще не попадают в ваше приложение. Деньги идут на ваш аккаунт Stripe, а не в Zugo. Zugo никогда не стоит между вами и вашей выручкой.

Каждая сборка перед выдачей проверяется в песочнице: «проверена» значит, что приложение реально загрузилось и отрисовалось, а не что кто-то просмотрел код глазами. У глубоких многостраничных сборок есть ещё чекпоинты и живой лог процесса: видно, как страницы оплаты собираются по шагам, вместо крутящегося спиннера.

Что нужно перед стартом?

Три вещи, и только одна из них требует реального времени:

1. Аккаунт Stripe. Создаётся бесплатно на stripe.com. Перед приёмом живых платежей Stripe попросит данные о бизнесе: эта верификация проходит между вами и Stripe.
2. API-ключи. В дашборде Stripe в разделе Developers → API keys лежат две пары: тестовые ключи (начинаются с pk_test_ и sk_test_) и боевые (pk_live_ и sk_live_). Начинайте с тестовых. Всегда.
3. Чёткое понимание, что вы продаёте. Разовая покупка или подписка? Одна цена или три тарифа? Чем конкретнее промпт, тем меньше правок потом.

Со стороны Zugo не нужно ничего, кроме аккаунта: стартовые кредиты бесплатны, карта не требуется. Если вы ещё ни разу не собирали продукт AI-билдером, общий процесс разобран в статье как создать приложение нейросетью; здесь мы считаем, что цель: именно платежи.

Как подключить оплату Stripe: по шагам

Конкретный пример. Допустим, вы пишете:

«Собери лендинг для моего сервиса разбора резюме. Один оффер: разовый разбор за $49. Добавь кнопку оплаты через Stripe и страницу благодарности после платежа».

Zugo собирает страницу, и как только ключи лежат в коннекторе, кнопка открывает настоящую сессию Stripe Checkout для вашего продукта за $49. Передумали насчёт цены или хотите добавить срочный вариант за $99? Просто скажите это в чате: это правка, а не пересборка. А если хочется спланировать структуру до генерации, режим Plan даёт сначала посмотреть план сборки.

За что может брать деньги сгенерированное приложение?

На практике: за всё, что поддерживает Stripe Checkout:

• Разовые платежи: цифровые продукты, услуги, бронирования, билеты на события, страница «оплатить счёт».
• Подписки: месячные и годовые тарифы, классическая страница цен SaaS-продукта.
• Закрытый контент: в связке с коннектором Supabase (или Zugo Cloud, встроенной базой) приложение проверяет, кто заплатил, прежде чем показывать премиум-страницы.

Паттерн важнее ниши. Платная рассылка, депозит за бронь фотостудии, банка чаевых на $5 в игре, которую вы собрали: механика чекаута везде одна. Если удобнее стартовать с рабочего макета, а не с пустого промпта, у Zugo есть 25 шаблонов в 5 категориях, а в витрине: живые примеры того, что люди уже опубликовали.

Тестовый режим и боевой: в чём разница?

Stripe держит два параллельных мира. Тестовый режим, это ключи pk_test_/sk_test_ и ненастоящие карты; деньги не двигаются никогда. Боевой режим, ключи pk_live_/sk_live_ и списания с реальных карт. Сгенерированный код между режимами не меняется: меняются только ключи в коннекторе.

Безопасный порядок такой: собираете и дорабатываете всё на тестовых ключах, проходите покупку от начала до конца тестовой картой, проверяете страницу успеха и логику после оплаты: и только потом вставляете боевые ключи. Если что-то сломано, вы узнаете об этом на фейковой карте, а не на карте клиента.

Что проверить перед переключением на боевые ключи?

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

1. Пройдите покупку до конца. Не до открытия чекаута, а до страницы после оплаты. Самая частая поломка сгенерированного сценария в том, что после успешного платежа пользователь возвращается на страницу тарифов и не понимает, купил он или нет.
2. Сверьте цену в трёх местах. Цифра на странице, цифра в чекауте Stripe и цифра в описании продукта в дашборде Stripe должны совпадать. Расхождение здесь превращается в спор по платежу, а спор дороже любой правки.
3. Проверьте доступ после оплаты. Если контент закрыт, выйдите из аккаунта и зайдите заново тем же пользователем. Логика «заплатил, значит видит» должна пережить перезаход, а не жить в памяти вкладки. За хранение этого признака отвечает база: как она подключается, разобрано в статье про приложение с Supabase.
4. Проверьте, где лежит secret-ключ. Ему место в коннекторе, а не в тексте промпта и не в видимой части страницы. Публикация приложения с боевым secret-ключом на странице означает, что чужой человек может создавать платежи от вашего имени.
5. Проверьте письмо. Если после оплаты обещано подтверждение, оно отправляется коннектором Resend, а не Stripe и не Zugo. Обещание письма без подключённого коннектора это просто текст на кнопке.

Какие ошибки встречаются чаще всего?

Поменяли один ключ из двух. Publishable и secret меняются парой. Оставленный тестовый secret при боевом publishable даёт ошибку прямо в момент оплаты, то есть в худшей возможной точке.

Тестовая карта в боевом режиме. Номер 4242 4242 4242 4242 работает только в тестовом мире Stripe. В боевом он не пройдёт, и это не поломка сборки.

Ждут, что отмена подписки закроет доступ сама. Не закроет, если вы об этом не попросили. Оплата и доступ это две разные вещи: доступ надо явно связать со статусом подписки, отдельной правкой и отдельной проверкой.

Считают, что чекаут решает вопрос валюты и страны. Какие валюты и способы оплаты вам доступны, определяет ваш аккаунт Stripe и юрисдикция бизнеса. Ни билдер, ни промпт на это не влияют.

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

Чего Zugo не делает?

Это важная часть, потому что «AI-билдер со Stripe» звучит так, будто он делает из вас готовый бизнес. Нет. Zugo собирает софт; коммерция вокруг него: на вас:

• Налоги. Sales tax, VAT, GST: собирать и перечислять их обязаны вы. У Stripe есть продукт Tax, который включается в дашборде Stripe, но настроить его, зарегистрироваться там, где вы должны платить налог, и сдавать отчётность: ваша задача.
• Возвраты и споры. Zugo не напишет вашу политику возвратов, а чарджбэки решаются между вами и Stripe. Возвраты делаются из дашборда Stripe.
• Одобрение аккаунта Stripe. Stripe сам решает, с какими бизнесами работает, и сам проверяет вашу личность. Zugo не может это ускорить или обойти.
• Сроки выплат. Когда деньги дойдут до вашего банковского счёта: настройка Stripe, а не Zugo.
• Юридические страницы. Пользовательское соглашение и политика конфиденциальности платного продукта требуют настоящей проверки, а не сгенерированной заглушки.

Ничего необычного здесь нет: так устроен любой стек, хоть написанный руками, хоть сгенерированный. Разница в том, что с Zugo программная часть сжимается с недель до минут, и настоящей работой становится именно этот чек-лист.

Что дальше, когда оплата работает?

Публикация это один клик, и приложение живёт на your-slug.zugo.run. Бесплатные публикации выходят с бейджем «Made with Zugo»; платные тарифы открывают собственные домены, и чекаут переезжает на ваш адрес, а именно там ему и место, когда речь о настоящих деньгах. Что для этого нужно сделать в DNS и когда домен реально окупается, разобрано в статье про свой домен для AI-приложения.

И вы не заперты внутри. Zugo экспортирует проект в GitHub как полноценный репозиторий, src/, package.json, vite.config, так что платёжный код принадлежит вам: читайте, аудируйте или отдайте разработчику позже. Подробности: в статье про экспорт приложения в GitHub.

Сколько это стоит: стартовых кредитов бесплатного тарифа хватает, чтобы пройти весь цикл на тестовых ключах. Pro, $25/мес: 20 000 кредитов, это примерно 16 полных платформ или 33 быстрых сборок, плюс собственные домены. Business, $50/мес. Реалистичный путь такой: бесплатно собрать прототип платного приложения, проверить чекаут в тестовом режиме и апгрейдиться, когда будете готовы переехать на свой домен и переключить ключи на боевые. Начать этот путь можно на https://zugo.dev, а ключи Stripe понадобятся только на том шаге, где вы дойдёте до самого чекаута.