ВНЕШНИЕ СЕРВИСЫ (Services) — Интеграции

Версия: 1.0.0
Дата: 2025-12-06

Принцип

Внешние сервисы = не делать самим. Подключать через API.
Специализированные решения лучше самописных.

1. ОПЛАТА

Провайдеры (Россия)

Способы оплаты (целевые)

Рекомендация

Основной:     ЮKassa (универсальность)
Альтернатива: Тинькофф (если основной счёт там)

Интеграция

Best Practices

• HTTPS обязателен — для платёжных страниц
• Идемпотентность — защита от дублей
• Webhook retry — провайдер повторяет если не 200
• Логирование — все транзакции в лог
• Тестовая среда — sandbox для разработки

Схема потока

[Checkout] → [Создать платёж] → [Редирект на ЮKassa]
                                        ↓
[Обновить заказ] ← [Webhook] ← [Клиент платит]
                                        ↓
                              [Return URL → Спасибо]

2. ДОСТАВКА

Провайдеры (Россия)

Способы доставки (целевые)

Функции интеграции

Агрегаторы

Best Practices

• Калькулятор на сайте — расчёт до checkout
• Карта ПВЗ — визуальный выбор
• Трекинг — ссылка в SMS/email
• Бесплатная доставка — от N рублей (мотивация)

Схема

[Корзина/Checkout] → [Ввод адреса] → [Подсказки DaData]
                            ↓
                     [Расчёт стоимости]
                     [СДЭК: 290₽, 2 дня]
                     [Почта: 200₽, 7 дней]
                            ↓
                     [Выбор способа]
                            ↓
[Заказ создан] → [Создать отправление в ТК] → [Трекинг]

3. АВТОРИЗАЦИЯ (OAuth)

Провайдеры

Вход по телефону

Рекомендуемый набор

1. Телефон + SMS (основной)
2. VK ID (соцсеть #1)
3. Яндекс ID (сервисы Яндекса)
4. Госуслуги (опционально, для доверия)

Best Practices

• Phone-first — телефон как идентификатор
• Passwordless — без пароля, только коды
• Гостевой checkout — покупка без регистрации
• Объединение аккаунтов — при конфликте
• Согласие — 152-ФЗ, обработка ПД

Схема OAuth

[Кнопка VK] → [Редирект на VK] → [Авторизация]
                                       ↓
[Создать/найти пользователя] ← [Callback с токеном]
         ↓
[Сессия создана]

4. EMAIL / SMS / PUSH

Email провайдеры

SMS провайдеры

Триггерные сообщения

Best Practices

• Транзакционные отдельно — высокий приоритет
• Отписка — в каждом письме
• Персонализация — имя, товары
• Тайминг — не ночью
• A/B тесты — тема письма

5. АНАЛИТИКА

Инструменты

E-commerce события

Настройка

// Яндекс.Метрика
ym(XXXXXX, 'reachGoal', 'purchase', {
  order_price: 2990,
  currency: 'RUB'
});

// GA4
gtag('event', 'purchase', {
  transaction_id: '2025-001234',
  value: 2990,
  currency: 'RUB',
  items: [...]
});

Best Practices

• Оба инструмента — Метрика + GA4
• Цели — настроить все этапы воронки
• E-commerce — включить расширенную аналитику
• UTM-метки — во всех кампаниях

6. ЧАТ / ПОДДЕРЖКА

Провайдеры

Каналы поддержки

Best Practices

• Быстрый ответ — до 5 минут в рабочее время
• Автоответы — нерабочее время
• FAQ бот — типовые вопросы
• Интеграция с CRM — история клиента

7. CDN / ХРАНИЛИЩЕ

Провайдеры

Что хранить в S3/CDN

Best Practices

• Cloudflare перед всем — кэширование + защита
• Оптимизация изображений — WebP, lazy load
• Версионирование — ?v=hash для кэша
• Бэкапы — регулярные, в отдельное хранилище

8. 1C / ERP / PIM

Варианты интеграции

Данные для синхронизации

PIM (Product Information Management)

Best Practices

• Мастер-данные в 1C — товары, цены
• Обогащение на сайте — описания, фото
• Инкрементальный обмен — только изменения
• Очереди — асинхронная обработка

9. МАРКЕТПЛЕЙСЫ

Интеграции

Данные для выгрузки

Best Practices

• Единый источник — PIM или 1C
• Автоматизация — расписание синхронизации
• Мониторинг — ошибки выгрузки
• Раздельные цены — для каждого канала

10. ПОИСК (внешний)

Провайдеры

Функции

Best Practices

• До 10к товаров — PostgreSQL FTS достаточно
• 10к+ товаров — Elasticsearch/Meilisearch
• Индексация — асинхронная, при изменении
• Тестирование — качество результатов

Сводная таблица

Версия: 1.0.0