Подключение Stripe

Требования

Перед интеграцией Stripe убедитесь, что у вас есть:

• Рабочее приложение MGX.
• Проект MGX уже подключен к проекту Supabase. (Подробнее о Supabase.)
• Созданные продукты и соответствующие цены в вашей панели управления Stripe.

Примечание: Режим Preview нельзя использовать для тестирования функции оплаты. Разверните приложение MGX и переключите Stripe в Test Mode, чтобы проверить интеграцию.

Тестовая карта:

• Номер карты: 4242 4242 4242 4242
• Срок действия: любая будущая дата
• CVC: любое 3-значное число

Настройка платежей Stripe

1. Подключите Supabase

   • Нажмите кнопку Supabase в правом верхнем углу MGX
   • Следуйте руководствам Подключение Supabase, чтобы выбрать целевой проект Supabase
   • После подключения вы сможете настроить параметры оплаты через Supabase

2. Опишите требования к подписке на естественном языке

   • Пример: Создай систему оплаты, которая поддерживает три тарифных плана подписки: $4.99 в неделю, $14.99 в месяц и $149.99 в год.

   После отправки Agent MGX сгенерирует кнопки конфигурации. Вам нужно будет заполнить как минимум два поля.

3. Нажмите кнопку Add Stripe Secret Key

   

   • Введите ваш секретный ключ Stripe в поле STRIPE_SECRET_KEY.
   • Для каждого плана введите соответствующий Stripe Price ID в поле, оканчивающееся на PRICE_ID.

   

   Получить ваш секретный ключ Stripe можно здесь: https://dashboard.stripe.com/test/apikeys

   Перейдите в Product Catalog > Products, получите ID цены одним из следующих способов:

   • В списке "Pricing" нажмите кнопку “More” справа от соответствующей цены, затем нажмите "Copy Price ID".

   

   Вы можете напрямую нажать на название цены, чтобы открыть страницу сведений, затем скопировать ID цены, показанный в правом верхнем углу.

   

   Наконец, аккуратно вставьте каждый ID цены в соответствующее поле ввода.

   

   Примечание: В целях конфиденциальности и безопасности никогда не вставляйте ваш секретный ключ напрямую в чат MGX. Его раскрытие может позволить несанкционированный доступ к вашему аккаунту Stripe. Вместо этого используйте кнопку MGX "Add API Key" для его безопасного хранения.

4. Нажмите кнопку Add Stripe Webhook Secret Key

   

   • Введите ваш секретный ключ Webhook

5. Как найти секретный ключ Webhook:

   В Stripe нажмите “Developers” в левом нижнем углу, затем выберите опцию Webhooks.

   

   На странице Webhooks нажмите кнопку "Add destination".

   

   Выберите события webhook, соответствующие потребностям вашего проекта:

   • checkout.session.async_payment_failed
   • checkout.session.async_payment_succeeded
   • checkout.session.completed
   • checkout.session.expired

   

   После нажатия "Continue" выберите "Webhook endpoint."

   

   Введите URL endpoint из Supabase.

   

6. Как найти URL endpoint Supabase:

   Нажмите View Edge Function в MGX.

   

   • Нажмите, чтобы выбрать edge function с соответствующим суффиксом _webhook.

     

   • В панели Details соответствующей edge function скопируйте Endpoint URL и вставьте его в Stripe Event Destination.

     

7. Протестируйте интеграцию

   Используйте Test Mode Stripe для тестирования платежей.

   Данные тестовой карты:

   • Номер карты: 4242 4242 4242 4242
   • Любая будущая дата истечения срока действия
   • Любой 3-значный CVC

FAQ

Почему я не могу тестировать платежи в режиме Preview?

Режим Preview работает в локальной среде, которая не предоставляет общедоступный URL Webhook. Чтобы получать события Stripe, необходимо развернуть приложение.

Как переключиться в Production Mode?

Вы можете отключить Test Mode в панели управления Stripe и использовать ваш рабочий Secret Key и Webhook Secret.

Как я могу проверить, прошел ли тестовый платеж успешно?

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