Руководство по интеграции CodesWholesale API — оптовые игровые ключи для разработчиков
CodesWholesale управляет одним из крупнейших оптовых API игровых ключей в Европе. Их каталог насчитывает свыше 50 000 SKU PC-игровых ключей для Steam, Epic Games Store, GOG и EA App — с доступом через API с ценами в реальном времени и автоматической доставкой ключей. В этом руководстве разобрано, как интегрировать этот каталог: что означает прямая интеграция с CodesWholesale, где она создаёт трения и как агрегированный API FoxReload предлагает более быструю и широкую альтернативу.
Что даёт API CodesWholesale
REST API CodesWholesale открывает полный оптовый каталог для одобренных B2B-партнёров. Ключевые возможности для разработчиков:
Доступ к каталогу — запросы по 50 000+ SKU по платформе (Steam, Epic, GOG, EA App), категории, издателю или ключевому слову. Ответы содержат метаданные тайтла, платформу, региональные ограничения и текущую оптовую цену.
Цены в реальном времени — оптовые цены актуальны, не кэшируются. API отражает текущее ценообразование, включая динамическую корректировку при изменении розничных цен. Это критично для реселлеров: устаревшие цены ведут к закупке дороже розницы.
Размещение заказов — программное размещение заказов по SKU с указанием количества. API обрабатывает резервирование и выполнение.
Автоматическая доставка ключей — купленные ключи передаются через ответ API или вебхук. После подтверждения заказа ручных операций не требуется.
Наличие в реальном времени — запрос актуальных остатков перед оформлением заказа. Подписка на уведомления о пополнении для тайтлов, которых нет в наличии.
Вебхуки — поддержка событийно-ориентированных архитектур: уведомления об изменении статуса заказа и о пополнении.
Прямая интеграция: требования и барьеры
Подключение напрямую к API CodesWholesale требует преодоления нескольких предварительных условий, которые останавливают многих реселлеров.
Юридическое лицо в ЕС
Наиболее существенный барьер: CodesWholesale требует зарегистрированное европейское юридическое лицо для прямых B2B-аккаунтов. Это жёсткое требование, а не предпочтение. Реселлеры из США, Великобритании, Азии, Ближнего Востока и других стран за пределами ЕС не могут открыть прямой аккаунт. Великобритания после Brexit также исключена.
Только это одно требование отсекает большинство глобальных реселлеров от прямого доступа.
Ручная модерация
Даже при наличии юрлица в ЕС доступ не самообслуживаемый. Заявки проходят ручную проверку: подача бизнес-документов, описание предполагаемого сценария использования и канала дистрибуции, оценка соответствия командой CodesWholesale. Процесс занимает от нескольких дней до нескольких недель, одобрение не гарантировано.
Технический онбординг API
После одобрения вы получаете API-учётные данные и доступ к документации разработчика. API CodesWholesale — стандартная REST-реализация, но понимание схемы идентификаторов продуктов, обработка правил региональных блокировок на игровых ключах и маппинг их каталога на внутреннюю модель продукта требует времени. Рассчитывайте минимум на неделю работы разработчика для базовой функциональной интеграции сверх простейшего запроса каталога.
Ожидания по минимальному объёму
Прямые B2B-аккаунты идут с неявными ожиданиями по ежемесячным объёмам закупок. Для начинающего реселлера или тестирующего рынок это создаёт давление на бизнес до появления стабильной выручки.
Реалистичный тайминг прямой интеграции
Для реселлера без юрлица в ЕС прямая интеграция с CodesWholesale невозможна. Для EU-реселлера, начинающего с нуля:
- Неделя 1: подготовка бизнес-документов и подача заявки
- Недели 1–2: ожидание ручной проверки
- Недели 2–3: настройка API-учётных данных, изучение документации, тестирование в sandbox
- Недели 3–4: маппинг каталога, тестирование флоу заказов, интеграция доставки ключей
- Неделя 4+: запуск в продакшн
Четыре недели — оптимистичная оценка.
FoxReload: агрегированный доступ к CodesWholesale
FoxReload — оптовый агрегатор цифровых товаров, который соединяет реселлеров с несколькими поставщиками — включая CodesWholesale — через единый унифицированный REST API. Модель агрегации решает ключевые проблемы прямой интеграции с поставщиком.
Не нужно юрлицо в ЕС
FoxReload работает с реселлерами по всему миру. Юрисдикция вашей регистрации не влияет на доступ. Реселлеры из США, Великобритании, Азии и Ближнего Востока получают каталог CodesWholesale через FoxReload без юрлица в ЕС.
Не нужен прямой процесс верификации
FoxReload управляет отношениями с поставщиками. Вы один раз подаёте заявку в FoxReload, получаете одобрение (обычно за 24–48 часов) и сразу получаете доступ к каталогу CodesWholesale вместе с 12 другими поставщиками. Отдельная заявка в CodesWholesale не требуется.
Сравнение цен между поставщиками
API FoxReload агрегирует цены CodesWholesale вместе с Driffle, PrepaidForge и другими поставщиками. По любому SKU можно запросить лучшую доступную оптовую цену среди всех источников. Это автоматический ценовой роутинг означает, что ваша интеграция всегда закупает по наиболее конкурентной ставке.
Единый маппинг каталога
FoxReload нормализует идентификаторы продуктов и метаданные каталога от разных поставщиков. Вы работаете с единой согласованной моделью продукта, не выстраивая маппинг для каждой собственной схемы идентификаторов поставщика.
Одна интеграция — несколько поставщиков
Одна REST API интеграция даёт доступ к глубине PC-каталога CodesWholesale плюс дополнительный каталог от других поставщиков. Если позже захотите добавить мобильные пополнения, подарочные карты или консольную валюту от других поставщиков FoxReload — это доп. настройка, а не новый интеграционный проект.
Сценарии использования
Платформа перепродажи игровых ключей — вы строите или управляете витриной, продающей PC-игровые ключи. API FoxReload даёт каталог CodesWholesale из 50 000+ SKU с автоматической закупкой и доставкой.
Мультикатегорийный маркетплейс — вы управляете маркетплейсом цифровых товаров шире игровых ключей. Агрегированный каталог FoxReload позволяет добавить PC-ключи от CodesWholesale вместе с другими категориями от других поставщиков через одно подключение.
Инструмент сравнения цен и арбитража — мультипоставщиковое ценообразование FoxReload позволяет строить инструменты, которые автоматически выбирают самого дешёвого оптового поставщика по каждому SKU, максимизируя маржу на каждой продаже.
White-label панель реселлера — вы строите дашборд реселлера для субдистрибьюторов. API FoxReload обеспечивает глубину каталога и данные по ценам для работы панели без управления прямыми отношениями с поставщиками.
Как начать работу с FoxReload
Перейдите на foxreload.com, отправьте данные о своём бизнесе и получите sandbox-учётные данные в течение 24–48 часов. Документация API покрывает аутентификацию, эндпоинты каталога, флоу заказов и доставку ключей в полном объёме. Разработчик с опытом работы с REST API завершит функциональную интеграцию менее чем за неделю.
