Stripe

Stripe принимает оплату прямо в приложении — картой, через Apple Pay или Google Pay.

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

Пять шагов:

1. Настроить Stripe
2. Настроить Apple Pay — по желанию
3. Добавить действие оплаты
4. Проверить на тестовых картах
5. Перейти на боевые ключи

1. Настройка Stripe

Нужно взять ключи из аккаунта Stripe и добавить их во FlutterFlow.

1. Заведите аккаунт Stripe или войдите в существующий.
2. В панели нажмите Developers.
3. Включите Test Mode справа сверху.
4. Перейдите на вкладку API keys.
5. Во FlutterFlow откройте Settings and Integrations > In App Purchases & Subscriptions > Stripe и включите Enable Stripe Payments.
6. Скопируйте Publishable Key и Secret Key со страницы API keys и вставьте их в соответствующие поля. Для тестового режима — в секцию Test Credentials.
7. В блоке Additional Settings заполните:
   1. Merchant Display Name (обязательно) — имя продавца, которое увидит пользователь при оплате.
   2. Merchant Country Code (обязательно) — двухбуквенный код страны по ISO: US, IN, AU.
   3. Apple Merchant ID (по желанию) — нужен для оплаты через Apple Pay, см. следующий шаг.
8. Нажмите Deploy.

Платёжный сервис Stripe развернётся как облачная функция Firebase — после этого приложение может принимать оплату.

2. Настройка Apple Pay

Три шага:

1. Создать Apple Merchant ID
2. Загрузить платёжный сертификат в Stripe
3. Указать Apple Merchant ID во FlutterFlow

2.1. Apple Merchant ID

1. В Certificates, Identifiers & Profiles откройте раздел Identifiers и выберите Merchant IDs.
2. Нажмите + справа сверху.
3. Введите Description и Identifier. Идентификатор обычно выглядит как merchant плюс имя пакета приложения (его видно на странице настроек FlutterFlow): например, merchant.com.domainname.appname.
4. Нажмите Continue.
5. Проверьте данные и нажмите Register, затем Done.
6. Вернитесь в Identifiers и выберите App IDs.
7. Откройте идентификатор своего приложения.
8. В блоке Capabilities отметьте Apple Pay Payment Processing.
9. Нажмите Configure, выберите созданный merchant-аккаунт и нажмите Continue.
10. Нажмите Save, затем подтвердите.

2.2. Платёжный сертификат в Stripe

1. На странице Settings панели Stripe выберите Payment methods.
2. В секции Wallets разверните Apple Pay.
3. Нажмите Configure — откроется страница Apple Pay settings.
4. В блоке iOS certificates нажмите + Add new application.
5. Скачается файл запроса на подпись сертификата (CSR); нажмите Continue.
6. В аккаунте Apple выберите Merchant ID, к которому привязываете сертификат, и нажмите Create Certificate.
7. Загрузите скачанный файл CSR.
8. Нажмите Activate, затем Download — сертификат сохранится на компьютер.
9. Вернитесь в диалог Stripe и нажмите Continue.
10. Загрузите файл сертификата.
11. Готовый сертификат появится в списке iOS certificates.

2.3. Apple Merchant ID во FlutterFlow

1. Откройте Settings and Integrations > In App Purchases & Subscriptions > Stripe.
2. В блоке Additional Settings заполните Apple Merchant ID.

3. Действие Stripe Payment

1. Выберите виджет — контейнер, кнопку и так далее.
2. В панели свойств справа откройте Actions и нажмите Open — откроется Action Flow Editor.
3. Нажмите + Add Action.
4. Справа найдите и выберите Stripe Payment (раздел Integrations).
5. В Amount укажите сумму — числом или из переменной. Сумма задаётся в минимальных единицах валюты: $24.99 передаётся как 2499, а ¥1925 — просто как 1925. Дробное значение округлится автоматически. Список валют без дробной части.
6. В Currency Code укажите валюту: USD, EUR, BRL. Неверный код — платёж не пройдёт.
7. Заполните Customer Email (обязательно) и Customer Name (по желанию) — значением или переменной. При включённой аутентификации оба берутся из Authenticated User.
8. В Description опишите покупку — это увидите и вы, и пользователь.
9. Чтобы принимать Google Pay или Apple Pay, включите соответствующие тумблеры. Для Apple Pay понадобится Merchant ID.
10. В Payment Sheet Theme выберите оформление: System Default, Light Theme или Dark Theme.
11. Задайте Primary Button Color и Button Text Color для окна оплаты.
12. В Output Variable Name укажите переменную, куда попадёт идентификатор платежа при успешной оплате.

4. Проверка

Оплату можно проверить на мобильном и в вебе до публикации:

1. Откройте Settings and Integrations > In App Purchases & Subscriptions > Stripe.
2. Убедитесь, что Is Production выключен.
3. Проверьте, что в Test Credentials введены правильные Publishable Key и Secret Key.
4. Выгрузите и запустите проект.
5. Платите любой из тестовых карт Stripe.

5. Переход на боевые ключи

1. Войдите в аккаунт Stripe и откройте Developers.
2. Выключите Test Mode справа сверху.
3. Откройте API keys и скопируйте Publishable Key и Secret Key.
4. Во FlutterFlow вставьте их в секцию Production Credentials.
5. Для Android — публикация в Google Play.
6. Для iOS — публикация в App Store.

---

Частые вопросы

Ошибка «Unknown error occurred»

Проверьте три вещи:

1. Код страны. В настройках Stripe во FlutterFlow иногда срабатывает трёхбуквенный код — «USA» вместо «US». Если ошибка не уходит, попробуйте изменить формат, удалите ранее развёрнутые функции в консоли Firebase и разверните их заново.
2. Авторизация. Stripe требует авторизованного пользователя — вызывайте действие только после входа.
3. Права облачных функций. У функции должна быть роль Cloud Functions Invoker для allUsers. Проверить можно в консоли Google Cloud: найдите функцию initStripePayment, откройте её и посмотрите вкладку Permissions. Обычно роль выдаётся сама, но лишний раз убедиться не помешает.