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

Приём онлайн-платежей через Stripe: карты, Apple Pay, Google Pay.

1. Обзор#

Stripe — глобальная платёжная платформа. В реестре Meni Stripe доступен к подключению в 46 странах. Интеграция Meni + Stripe позволяет:

• 💳 Принимать оплату картами (Visa, Mastercard, AmEx)
• 📱 Apple Pay / Google Pay — оплата в одно касание
• 💰 Получать выплаты на ваш банковский счёт
• 🔄 Обрабатывать возвраты из админ-панели
• 💵 Чаевые — гость добавляет чаевые при оплате
• 📊 Отчёты — полная финансовая аналитика

2. Требования#

• ✅ Аккаунт Meni (онлайн-оплата доступна на любом тарифе, включая бесплатный)
• ✅ Аккаунт Stripe (бесплатная регистрация на stripe.com)
• ✅ Банковский счёт для выплат (в валюте вашей страны)
• ✅ Документы для верификации (паспорт / ID, документы компании)

Поддерживаемые страны#

Stripe предлагается к подключению в 46 странах:

Грузии и Турции в этом списке нет — Stripe там не открывает счета продавцов, поэтому в панели для локации с такой страной карточка Stripe не появится. Для Грузии подключайте Bank of Georgia (iPay) или TBC Bank, для Ближнего Востока — PayTabs; глобальная альтернатива, работающая почти везде, — PayPal. Если Stripe уже подключён у вас на юрлицо другой страны, он остаётся в списке и продолжает работать.

3. Создание аккаунта Stripe#

Шаг 1. Регистрация#

1. Перейдите на stripe.com → Start now
2. Укажите email и создайте пароль
3. Подтвердите email

Шаг 2. Верификация бизнеса#

Stripe запросит:

Верификация обычно занимает 1–3 рабочих дня.

Шаг 3. Получите API-ключи#

1. В дашборде Stripe: Developers → API keys
2. Скопируйте:
   • Publishable key (pk_live_...)
   • Secret key (sk_live_...)

⚠️ Важно: для тестирования используйте ключи из режима Test mode (pk_test_..., sk_test_...).

4. Подключение к Meni#

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

Откройте Магазин приложений → категория «Финансы» → карточка Stripe → «Настроить» — блок подключения откроется модалкой прямо в магазине. Привычный путь тоже работает: Локации → карточка локации → вкладка «Оплаты» (секция «Оплата гостем»), кнопка «Подключить» у карточки Stripe.

Мастер подключения (рекомендуется)#

Пошаговый мастер (≈10 минут) проводит через весь процесс, показывая, куда нажимать в дашборде Stripe:

1. Выберите режим — тестовый или боевой. Режим в Stripe и переключатель «Тестовый / Боевой» в Meni должны совпадать.
2. Скопируйте ключи — Developers → API keys: Secret key (sk_test_… / sk_live_…) обязателен, Publishable key (pk_…) — по желанию.
3. Добавьте вебхук — Developers → Webhooks → Add endpoint, а в поле Endpoint URL вставьте адрес вебхука Meni, который мастер даёт кнопкой «Копировать». Без вебхука Stripe не сообщит, что заказ оплачен, и заказ может остаться в статусе «ожидает».
4. Выберите события — в блоке «Select events» обязательно добавьте checkout.session.completed (именно оно подтверждает оплату заказа), а для отложенных способов оплаты — ещё checkout.session.async_payment_succeeded и checkout.session.async_payment_failed. Затем нажмите «Add endpoint». Без этих событий вебхук создан, но об оплате не сообщит.
5. Скопируйте Webhook signing secret (whsec_…) — необязательное поле, но с ним включается проверка подписи уведомлений.
6. Подключить — введённые значения уходят на защищённый бэкенд.

Короткая форма#

Если вы уже знаете, где что лежит в Stripe, откройте инлайн-форму подключения и заполните те же поля: Secret key, Webhook signing secret (опц.), Publishable key (опц.) плюс переключатель режима.

Stripe Connect не используется. Meni не выступает платформой-посредником: вы вводите ключи своего аккаунта, а не даёте Meni доступ к нему через OAuth.

5. Настройка способов оплаты#

Банковские карты#

Автоматически включены при подключении Stripe:

• Visa / Mastercard — все страны
• American Express — большинство стран
• Diners Club / Discover — выборочно

Apple Pay и Google Pay#

Отдельных тумблеров в Meni для них нет: оплата идёт на hosted-странице Stripe Checkout, поэтому кошельки включаются на стороне Stripe.

• Google Pay — работает сразу после подключения Stripe (Android, Chrome).
• Apple Pay — Stripe требует подтвердить домен: Settings → Payment methods → Apple Pay → Add new domain. После верификации кнопка появится на iOS/Safari.

Другие методы#

Через Stripe Dashboard можно включить:

Включите нужные методы в Stripe Dashboard → Settings → Payment methods.

6. Чаевые#

Настройка#

1. Локации → карточка локации → вкладка «Общее» → тумблер «Чаевые».
2. Как это работает:

Как это видит гость#

При оплате после выбора блюд:

Ваш заказ: 45₾

Добавить чаевые?
[ 10% (4.50₾) ] [ 15% (6.75₾) ] [ 20% (9.00₾) ] [ Другая сумма ]
[ Без чаевых ]

ИТОГО: 49.50₾   [Оплатить →]

Отчёты по чаевым#

Раздел Финансы:

• вкладка «Обзор» — общая сумма чаевых за период со сравнением с предыдущим;
• вкладка «Продажи» — чаевые в разрезе официантов.

7. Выплаты на ваш счёт#

Как Stripe выплачивает деньги#

Гость оплачивает → Stripe удерживает → Через T+2 дня → Деньги на вашем счёте

Настройка расписания#

В Stripe Dashboard → Settings → Payouts:

• Ежедневно (рекомендуется)
• Еженедельно (конкретный день недели)
• Ежемесячно

8. Комиссии Stripe#

💡 Meni не берёт дополнительную комиссию сверх Stripe.

9. Возвраты#

Возврат денег через Stripe запускается из двух мест — смотря как обслуживался заказ.

Возвраты интернет-магазина (RMA)#

1. Раздел Возвраты → карточка заявки.
2. Выберите режим возврата: на исходный способ оплаты (Stripe), подарочной картой (store credit) или обменом.
3. Отметьте позиции (полный или частичный возврат) и решите, возвращать ли товар на склад.
4. Деньги уходят прямо со страницы; на карту гостя они приходят обычно за 5–10 рабочих дней.

Возвраты на кассе#

В POS возврат оформляется по чеку — полный или частичный, есть и обмен с перепродажей. Кассовая смена при этом должна быть открыта.

В карточке заказа в разделе Заказы видны бейджи оформленных возвратов со ссылкой на заявку.

Автоматических правил возврата («отмена до начала готовки → вернуть деньги сами») в системе нет — решение о возврате всегда принимает человек.

10. Безопасность#

PCI DSS#

• Meni не хранит данные карт — всё обрабатывает Stripe
• Stripe сертифицирован как PCI Level 1 (высший уровень)
• Данные карт шифруются и токенизируются

3D Secure#

• Автоматическая проверка 3D Secure для карт EU (SCA/PSD2)
• Снижает мошенничество и чарджбэки
• Для гостя: подтверждение в приложении банка

Radar (защита от мошенничества)#

Stripe Radar автоматически блокирует подозрительные транзакции:

• Необычный паттерн покупок
• Карты из чёрных списков
• Геолокационные аномалии

11. Тестирование#

Перед включением в продакшн протестируйте:

Тестовые карты Stripe#

CVV: любые 3 цифры. Дата: любая будущая. ZIP: любой.

Как тестировать#

1. При подключении выберите переключатель «Тестовый режим» (он у каждого провайдера свой).
2. Используйте тестовые ключи (pk_test_..., sk_test_...) — и вебхук, созданный в том же тестовом режиме Stripe.
3. Сделайте тестовый заказ → оплатите тестовой картой.
4. Проверьте статус заказа в разделе Заказы — должно стать «Оплачен».
5. Когда всё работает — переподключите провайдера с боевыми ключами в режиме «Боевой».

12. Альтернативные провайдеры#

Для стран без Stripe или как дополнение — уже готовые к подключению:

Ещё 94 провайдера (Adyen, PayTR, ЮKassa, LiqPay, Mercado Pago, Razorpay и др.) уже есть в списке, но отображаются серым — интеграция ещё тестируется. Полный обзор — в разделе Оплата.

Подключение любого провайдера: Магазин приложений → категория «Финансы» → карточка провайдера → «Настроить», либо привычным путём Локации → карточка локации → вкладка «Оплаты».

13. Частые вопросы#

Когда я получу деньги?#

Через 2 рабочих дня после оплаты (T+2). Первая выплата может занять 7–14 дней (пока Stripe верифицирует аккаунт).

Гость хочет оплатить наличными — как быть?#

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

Можно ли подключить и Stripe, и BOG iPay?#

Да. На вкладке «Оплаты» можно включить несколько провайдеров сразу — на чекауте гость увидит по кнопке на каждого, подписанной именем провайдера.

Stripe заблокировал аккаунт — что делать?#

1. Проверьте email — Stripe присылает причину
2. Обычно требуется дополнительная верификация
3. Обратитесь в Stripe Support: support.stripe.com
4. На время блокировки можно использовать альтернативный провайдер

Как минимизировать комиссию?#

• Поощряйте оплату картами EU (1.5% вместо 2.9%)
• Используйте SEPA для крупных сумм (0.35€ фикс)
• При большом обороте (>100K€/мес) — запросите у Stripe индивидуальный тариф

14. Поддержка#

• Stripe: support.stripe.com
• Meni: support@cenaly.ru → тема «Stripe / Оплата»
• Stripe Status: status.stripe.com (проверка работоспособности)