Как создать, обновить или удалить токен WB API
Пошаговые инструкции для каждого типа токена
Дата обновления: 03.04.2026
Важные правила
Перед созданием токена ознакомьтесь с ключевыми моментами:
- Создавать и удалять токены может только владелец личного кабинета
- Срок действия токена — 180 дней. За 3 дня до истечения срока владельцу придёт уведомление в «колокольчик» в правом верхнем углу личного кабинета продавца
- Токен показывается только один раз при создании — сразу сохраните его в надёжном месте
- При смене владельца все токены перестают работать — новому владельцу нужно создать их заново
- Можно создать до 20 активных токенов на один магазин
Подробнее о безопасном хранении и работе с токенами — в статье «Безопасность данных продавца при работе с WB API»
Какой тип токена создать?
Выберите раздел инструкции в зависимости от вашей задачи:
| Задача | Какой токен создать |
|---|---|
| Подключаю сервис из Каталога решений | Сервисный (или OAuth 2.0) |
| Подключаю свою программу или on-premise систему | Персональный |
| Другие случаи | Базовый |
| Тестирование в песочнице | Тестовый |
Подробнее о различиях между типами и когда какой выбрать — в статье «Способы подключения к WB API». Если не уверены, облачная у вас программа или локальная — в статье «Облачный сервис или локальное решение»
Как начать создание токена
Прежде чем создавать токен любого типа, выполните следующие шаги:
- В личном кабинете WB Партнёры откройте окно профиля, нажав на название вашей организации в правом верхнем углу экрана
- Выберите в меню профиля раздел Интеграции по API
- Нажмите «+ Создать токен»
Откроется окно создания токена с двумя вкладками: «Для сервиса из каталога» и «Для интеграции вручную».
Дальнейшие действия зависят от типа токена — выберите соответствующий раздел инструкции ниже.
Как создать Сервисный токен
Сервисный токен используется для подключения конкретного облачного сервиса из официального Каталога решений для бизнеса на Wildberries.
Когда использовать: если вы подключаете готовый облачный сервис, который есть в Каталоге.
Как создать Персональный токен
Персональный токен предназначен для предоставления доступа к данным продавца вашим собственным программам или готовым корпоративным системам в редакции on-premise, развёрнутым на вашей инфраструктуре.
Когда использовать: если вы подключаете собственную программу или готовую систему (например, локальную версию 1С, ERP, CRM) на ваших серверах или компьютерах.
Как создать Базовый токен
Базовый токен предоставляет доступ к ограниченному списку категорий данных и используется, когда не подходят Сервисный или Персональный токены.
Когда использовать: для тестирования интеграции на реальных данных или в других случаях, когда другие типы токенов не подходят.
Как создать Тестовый токен
Тестовый токен предназначен для безопасного тестирования и отладки интеграций в песочнице — изолированной среде с тестовыми данными.
Когда использовать: для разработки и тестирования без риска для реальных данных магазина.
Подробнее — в статье «Тестовый токен и Песочница WB API»
Как удалить токен
Если есть подозрение, что токен скомпрометирован, немедленно удалите его:
- Откройте окно профиля на портале и выберите Интеграции по API
- Найдите нужный токен в списке и нажмите «Удалить»
- Подтвердите удаление
- Создайте новый токен и обновите его в настройках системы
При подозрении на несанкционированный доступ создайте сообщение в поддержке продавцов Wildberries, категория «Безопасность личного кабинета», тема «Несанкционированный вход».
Как обновить токен
Токены действуют 180 дней, после чего перестают работать. За 3 дня до завершения срока владельцу придёт уведомление.
Рекомендуемый план действий
Начинайте обновление за 7–14 дней до завершения срока действия:
- Откройте раздел Интеграции по API в окне профиля
- Найдите токен, который нужно обновить
- Нажмите кнопку «Дублировать» — откроется окно создания токена с такими же настройками. Подтвердите создание и скопируйте новый токен
- Замените старый токен на новый во всех системах, где он используется
- Проверьте работоспособность интеграции с новым токеном в течение нескольких дней
- Удалите старый токен только после того, как убедитесь, что новый работает корректно
Совет: настройте напоминание в календаре за 2 недели до истечения срока действия токена.