Маркетплейс под ключ - двухсторонняя площадка с эскроу и чатами

Почему маркетплейс - это сложнее, чем кажется

Любой может за выходные собрать сайт-каталог. Маркетплейс - другой уровень. Тут нужно одновременно решать пять задач: показ товара, удержание продавца, защита покупателя, антифрод, разрешение спорных ситуаций. Если хоть одна из этих частей хромает - площадка не взлетает.

Этот репозиторий собран с уже решёнными пятью задачами. Я не учился на чужих ошибках - я набил все шишки сам. Эскроу-логика, разделение баланса между площадкой и продавцом, диспуты, лимиты на новые аккаунты, отслеживание подозрительных паттернов - всё внутри.

Что входит в репозиторий

Витрина и каталог

• Главная страница с категориями и подборками
• Карточка товара с галереей фото, видео, отзывами
• Поиск с автодополнением и фильтрами по категории, цене, рейтингу
• Лендинги категорий со своим SEO-контентом
• Подборки «бестселлеры», «новое», «рекомендации»
• Семантический поиск через эмбеддинги (опционально, требует OpenAI ключ)

Продавцы и их кабинет

• Верификация: документ, селфи, реквизиты для выплат
• Кабинет продавца: статистика просмотров, конверсий, выручки
• Управление товарами: создание, редактирование, остатки, цены
• История заказов с фильтрами и поиском
• Запрос на выплату с автоматической проверкой баланса

Платежи и эскроу

• Оплата идёт на счёт площадки, удерживается до подтверждения покупки
• Автоматический релиз через N дней после доставки
• Возможность открыть диспут до момента релиза
• Разделение комиссии: твой процент площадки + сумма продавцу
• Поддержка YooKassa, CloudPayments, Yandex Pay, СБП

Чаты и коммуникация

• Чат покупатель-продавец с историей по каждому заказу
• Чат с поддержкой площадки
• Уведомления в Telegram-бот и на email
• Запрет на обмен контактами для увода сделки за пределы площадки (антифрод)

Рейтинги и отзывы

• Отзывы только от верифицированных покупателей (после оплаты)
• Модерация отзывов: автоматический фильтр + ручная проверка
• Ответ продавца на отзыв
• Рейтинг с разбивкой по аспектам (качество, сроки, общение)

Архитектура: что под капотом

Главная сложность маркетплейса - это согласованность данных. Покупатель оплатил, продавец получил уведомление, баланс площадки изменился, история транзакций пополнилась. Если одно из этих звеньев упадёт - получишь несчастного клиента и потерю репутации.

В репозитории все критичные операции обёрнуты в транзакции PostgreSQL. Платёж, изменение баланса, апдейт заказа - либо всё, либо ничего. Дополнительно стоит идемпотентность на webhook'ах - можешь спокойно ретраить, дубль не пройдёт.

• Next.js 14 App Router - SSR карточек товаров для SEO
• Prisma + PostgreSQL - типизированные транзакции, миграции
• Redis - очереди вебхуков, кэш каталога, rate-limit
• S3-совместимое хранилище для фото товаров (Yandex Object Storage / R2)
• Telegram Bot API для уведомлений и чата с саппортом

Под какие ниши подходит

• Услуги: фрилансеры, мастера, репетиторы, тренеры
• Цифровые продукты: шаблоны, пресеты, иллюстрации, музыка
• Информационно-консультационный контент: программы, мастер-классы, гайды
• Локальные товары: handmade, фермерская продукция
• B2B-каталоги: оптовые поставщики, корпоративные сервисы
• Аренда: оборудование, помещения, техника

Юр. чек-лист для маркетплейса в России

Маркетплейс - это сложная юр. конструкция. Ты не просто площадка с товарами - ты посредник между покупателем и продавцом, и закон 152-ФЗ требует от тебя обработки данных обеих сторон. Плюс агентский договор с продавцами, оферта для покупателей, политика возвратов. Всё это в репозитории есть как шаблоны - твоя задача только подписать у юриста.

• Договор-оферта для покупателей (PDF + текст в репозитории)
• Агентский договор с продавцами
• Политика обработки персональных данных
• Политика возвратов и обмена
• Правила площадки
• Согласие на обработку cookies

FAQ

Подойдёт ли для микро-ниши с 10-20 продавцами

Да, репозиторий работает на любом масштабе. PostgreSQL спокойно держит миллионы записей. Узкое горлышко - не код, а трафик и маркетинг ниши. Если ниша маленькая, начни с десяти продавцов - тебе хватит. Технически можешь масштабироваться до десятков тысяч без изменений в коде.

Как обрабатывать диспуты

В коде заложена базовая модель: покупатель открывает диспут до релиза средств, продавец отвечает, админ принимает решение. Это интерфейс - финальная политика разрешения за тобой. В админке есть страница «Диспуты» со списком всех открытых кейсов.

Нужна ли мне юр. регистрация

Для приёма платежей с маркетплейса - да, ИП или ООО. Без юрлица процессинги типа CloudPayments и YooKassa не подключатся. Если только запускаешь - сначала зарегистрируй ИП на УСН 6%, потом подключай эквайринг.

Можно ли сделать продажу подписок вместо разовых сделок

Да, в репозитории есть модуль рекуррентных платежей через CloudPayments (рекуррент-токен). Включается одной строкой в конфиге - и каждая «сделка» становится подпиской с автосписанием.

Когда брать готовое, а когда писать своё

Готовое имеет смысл если: твоя экспертиза - не в разработке, тебе важна скорость, ты хочешь протестировать гипотезу за месяц, а не за полгода. Своё разрабатывать стоит, если у тебя в команде есть тимлид с пятилетним опытом, бюджет на 6 месяцев работы и готовность сжечь миллион-два на эксперименты с архитектурой.

В 95% случаев готовое выгоднее. Маркетплейсы выживают не за счёт уникального кода, а за счёт уникальной аудитории и качества операций. Код - это просто инструмент.