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

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

1. Обзор

Stripe — глобальная платёжная платформа, работающая в 47+ странах. Интеграция Meni + Stripe позволяет:

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

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

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

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

Stripe работает в 47+ странах. Основные для Meni:

*Для стран где Stripe недоступен напрямую, используется Stripe Atlas или альтернативные провайдеры (BOG Pay для Грузии, İyzico для Турции).

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

Быстрый способ (рекомендуется)

1. В Meni: Настройки → Оплата → Stripe → Подключить
2. Нажмите «Подключить через Stripe»
3. Вы будете перенаправлены на Stripe Connect
4. Авторизуйтесь в вашем аккаунте Stripe
5. Подтвердите доступ
6. Готово — вы вернётесь в Meni с подключённым Stripe

Ручной способ (через API-ключи)

1. Настройки → Оплата → Stripe → Ручная настройка
2. Введите:
   • Publishable Key (pk_live_...)
   • Secret Key (sk_live_...)
3. Нажмите Проверить подключение
4. При успехе: Сохранить

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

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

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

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

Apple Pay

1. Настройки → Оплата → Apple Pay → Включить
2. Добавьте и верифицируйте ваш домен в Stripe Dashboard:
   • Settings → Apple Pay → Add new domain
   • Загрузите верификационный файл
3. Apple Pay появится как опция на iOS/Safari

Google Pay

Включается автоматически при подключении Stripe. Работает на Android и в Chrome.

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

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

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

6. Чаевые

Настройка

1. Настройки → Оплата → Чаевые
2. Варианты:

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

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

Ваш заказ: 45₾

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

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

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

Аналитика → Чаевые:

• Общая сумма чаевых за период
• Средний % чаевых
• Чаевые по сотрудникам
• Тренд (растут/падают)

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

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

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

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

В Stripe Dashboard → Settings → Payouts:

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

8. Комиссии Stripe

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

9. Возвраты

Полный возврат

1. Заказы → выберите заказ → Возврат → Полный
2. Деньги возвращаются на карту гостя через 5–10 рабочих дней
3. Stripe возвращает комиссию (в большинстве случаев)

Частичный возврат

1. Заказы → заказ → Возврат → Частичный
2. Укажите сумму или выберите позиции
3. Гость получает частичный возврат

Автоматические возвраты

Настройте правила в Настройки → Оплата → Возвраты:

• Отмена заказа до начала готовки → автоматический полный возврат
• Отмена после начала готовки → требует подтверждения менеджера

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_...)
3. Сделайте тестовый заказ → оплатите тестовой картой
4. Проверьте: чек, статус заказа, аналитику
5. Переключите на Режим: Боевой когда всё работает

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

Для стран без Stripe или как дополнение:

Подключение альтернативных провайдеров: Настройки → Оплата → выберите провайдера.

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

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

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

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

Meni поддерживает смешанную оплату. Отметьте заказ как «Оплата наличными» — фискальный чек будет сформирован, но 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@meni.ge → тема «Stripe / Оплата»
• Stripe Status: status.stripe.com (проверка работоспособности)