Справочник ошибок
Все коды ошибок MeerPartners в одной таблице: что значит код и что делать. Ошибки кабинета, выплат, офферов, команды и API-ошибки постбэка и аутентификации.
Полный список кодов ошибок с расшифровкой и действием. Коды раздела «Кабинет» — это реальные user-facing сообщения портала. Коды раздела «API» возвращаются на серверных эндпоинтах (постбэк, аутентификация). Сценарии по шагам — в Решении проблем.
Общие ошибки
| Код | Что значит | Что делать |
|---|---|---|
UNAUTHENTICATED | Необходимо войти в систему | Войдите через MeerID |
FORBIDDEN | Недостаточно прав | Действие недоступно для вашей роли/доступа |
VALIDATION_ERROR | Ошибка валидации | Проверьте корректность введённых данных |
RATE_LIMITED | Слишком часто, попробуйте позже | Снизьте частоту запросов и повторите |
UPSTREAM_UNAVAILABLE | Нет связи с сервером | Повторите позже; если повторяется — поддержка |
UNKNOWN_ERROR | Произошла ошибка | Обновите страницу; при повторе — поддержка |
Выплаты и баланс
| Код | Что значит | Что делать |
|---|---|---|
BELOW_MIN_PAYOUT | Сумма меньше минимума | Накопите до порога (RUB 500 / USD 10 / EUR 10) |
INSUFFICIENT_BALANCE | Недостаточно средств | Часть комиссий может быть в hold |
PAYOUT_PENDING_EXISTS | Уже есть необработанная заявка | Дождитесь завершения текущей заявки |
NO_PAYOUT_METHOD | Добавьте метод вывода | Укажите реквизиты в методах вывода |
PAYOUT_METHOD_NOT_FOUND | Метод вывода не найден | Выберите или добавьте метод заново |
KYC_REQUIRED | Пройдите KYC для вывода | Верифицируйтесь — KYC и лимиты |
KYC_ALREADY_SUBMITTED | KYC уже отправлен | Дождитесь результата проверки |
Бизнес: пополнение и платежи
| Код | Что значит | Что делать |
|---|---|---|
DEPOSIT_BELOW_MIN | Минимальная сумма пополнения | Увеличьте сумму пополнения эскроу |
PAYMENT_PROVIDER_UNAVAILABLE | Платёжный провайдер недоступен | Повторите позже или смените метод |
Офферы, ссылки и программа
| Код | Что значит | Что делать |
|---|---|---|
OFFER_NOT_FOUND | Оффер не найден | Проверьте ссылку/доступ к офферу |
OFFER_PAUSED | Оффер на паузе | Дождитесь возобновления оффера |
LINK_LIMIT_REACHED | Достигнут лимит ссылок для этого оффера | Используйте sub_id вместо новых ссылок |
MULTILEVEL_DISABLED | Многоуровневая программа недоступна | На этом оффере сетевые уровни не включены |
SELF_REFERRAL_FORBIDDEN | Нельзя пригласить самого себя | Используйте код другого инфлюенсера |
Команда и приглашения
| Код | Что значит | Что делать |
|---|---|---|
INVITE_NOT_FOUND | Приглашение не найдено | Запросите новое приглашение |
INVITE_EXPIRED | Срок действия приглашения истёк | Запросите новое приглашение |
INVITE_REVOKED | Приглашение отозвано | Обратитесь к пригласившему |
INVITE_EXHAUSTED | Лимит использований приглашения исчерпан | Запросите новое приглашение |
ALREADY_MEMBER | Вы уже являетесь участником этой команды | Действие не требуется |
MEMBER_NOT_FOUND | Участник не найден | Обновите список участников |
CANNOT_REMOVE_SELF | Нельзя удалить самого себя | Передайте права или покиньте команду иначе |
CANNOT_REMOVE_OWNER | Нельзя удалить владельца команды | Сначала смените владельца |
API: постбэк (S2S конверсии)
Возвращаются на эндпоинте POST /api/v1/postback. Подробнее — Постбэк и Коды ошибок API.
| Код | Что значит | Что делать |
|---|---|---|
POSTBACK_BAD_SIGNATURE | HMAC-подпись не совпала | Сверьте алгоритм подписи и тело запроса |
POSTBACK_STALE | X-Timestamp вне окна ±300 c (анти-replay) | Синхронизируйте часы сервера (NTP) |
POSTBACK_KEY_INVALID | API-ключ не найден или отозван | Проверьте X-Api-Key-Id и скоуп postback |
POSTBACK_DUPLICATE | Дубль по external_order_id | Ничего; идемпотентный no-op ({duplicate:true}) |
OFFER_UNKNOWN | Оффер из постбэка не найден у tenant | Проверьте offer_code/offer_id и принадлежность |
OFFER_INACTIVE | Оффер архивирован/неактивен | Активируйте оффер или проверьте код |
Постбэк отвечает 2xx при успехе и дубле
Невалидная подпись, ключ или оффер дают 4xx; успешная и повторная (дубль) обработка — 2xx. Это специально, чтобы ваш сервер не ретраил вечно. Ретраи по external_order_id безопасны.
API: аутентификация и доступ
Возвращаются при работе с JWT и HMAC-подписью S2S. Детали — Аутентификация API и API-ключи и подпись.
| Код | Что значит | Что делать |
|---|---|---|
TOKEN_EXPIRED | Срок действия JWT истёк | Обновите токен (access 15 мин / refresh 30 дней) |
TOKEN_INVALID | Токен невалиден или подделан | Войдите заново через MeerID |
TENANT_API_KEY_INVALID | API-ключ tenant недействителен | Проверьте X-Api-Key-Id / выпустите новый |
TENANT_API_KEY_SCOPE | У ключа нет нужного скоупа | Нужен скоуп postback / sso / readonly |
RATE_LIMIT_EXCEEDED | Превышен лимит запросов | Снизьте частоту, добавьте бэкофф |
Названия кодов аутентификации
Точные коды и формат ответа сервера для аутентификации/постбэка смотрите в разделе Интеграция и API — это источник правды для серверных кодов. Тексты ошибок кабинета (разделы выше) берутся из интерфейса портала.
Бизнес-аккаунт (создание)
| Код | Что значит | Что делать |
|---|---|---|
TENANT_SLUG_TAKEN | Адрес (slug) бизнеса занят | Выберите другой уникальный slug |