Обработка ошибок в Android SDK

Каждая ошибка, возвращаемая SDK, имеет тип AdaptyError.

Если эти решения не помогли, загляните в раздел Другие проблемы — там описаны шаги, которые стоит предпринять перед обращением в поддержку, чтобы мы могли помочь вам быстрее.

ОшибкаРешение
UNKNOWNНеизвестная или непредвиденная ошибка.
ITEM_UNAVAILABLEЭта ошибка чаще всего возникает на этапе тестирования. Возможные причины: продукты отсутствуют в продакшне или пользователь не входит в группу тестировщиков в Google Play.
ADAPTY_NOT_INITIALIZEDSDK Adapty не активирован. Необходимо правильно настроить Adapty SDK с помощью метода Adapty.activate.
PRODUCT_NOT_FOUNDПродукт, запрошенный для покупки, недоступен в сторе.
INVALID_JSON

JSON локального резервного пейвола невалиден.

Исправьте стандартный английский пейвол, затем замените недействительные локальные пейволы. Подробнее о том, как исправить пейвол, читайте в разделе Кастомизация пейвола с помощью Remote Config, а о замене локальных пейволов — в разделе Настройка локальных резервных пейволов.

CURRENT_SUBSCRIPTION_TO_UPDATE

_NOT_FOUND_IN_HISTORY

Исходная подписка, которую нужно заменить, не найдена среди активных подписок.
BILLING_SERVICE_TIMEOUTЗапрос превысил максимальное время ожидания до получения ответа от Google Play. Причиной может быть, например, задержка при выполнении действия, запрошенного вызовом Play Billing Library.
FEATURE_NOT_SUPPORTEDЗапрошенная функция не поддерживается Play Store на данном устройстве.
BILLING_SERVICE_DISCONNECTEDСоединение клиентского приложения с сервисом Google Play Store через BillingClient было разорвано.
BILLING_SERVICE_UNAVAILABLEСервис Google Play Billing в данный момент недоступен. В большинстве случаев это означает проблему с сетевым подключением между клиентским устройством и серверами Google Play Billing.
BILLING_UNAVAILABLE

В процессе покупки возникла ошибка биллинга. Возможные причины:

1. Приложение Play Store на устройстве пользователя отсутствует или устарело.

2. Пользователь находится в неподдерживаемой стране.

3. Пользователь входит в корпоративный аккаунт, где администратор отключил возможность покупок.

4. Google Play не смог списать средства с платёжного метода пользователя (например, истёк срок действия кредитной карты).

5. Пользователь не авторизован в приложении Play Store.

DEVELOPER_ERRORAPI используется некорректно.
BILLING_ERRORВнутренняя проблема самого Google Play.
ITEM_ALREADY_OWNEDПродукт уже куплен.
ITEM_NOT_OWNEDЗапрошенное действие с товаром не выполнено, так как он не принадлежит пользователю.
BILLING_NETWORK_ERRORПроблема с сетевым соединением между устройством и системами Play.
NO_PRODUCT_IDS_FOUND

Ни один из продуктов пейвола недоступен в сторе.

Если вы столкнулись с этой ошибкой, выполните следующие шаги:

  1. Убедитесь, что все продукты добавлены в дашборд Adapty.
  2. Проверьте, что Package name вашего приложения совпадает с указанным в Google Play Console.
  3. Убедитесь, что идентификаторы продуктов из сторов совпадают с теми, что добавлены в дашборд. Обратите внимание: идентификаторы не должны содержать Bundle ID, если он не включён в стор изначально.
  4. Убедитесь, что статус платного приложения в налоговых настройках Google — Active. Проверьте актуальность налоговой информации и действительность сертификатов.
  5. Проверьте, привязан ли к приложению банковский счёт для возможности монетизации.
  6. Проверьте, доступны ли продукты в вашем регионе.
  7. Убедитесь, что приложение находится в одном из треков тестирования. Трек Internal testing — наиболее простой вариант, так как не требует проверки и скрывает приложение от покупателей.
NO_PURCHASES_TO_RESTOREGoogle Play не нашёл покупку для восстановления.
AUTHENTICATION_ERRORНеобходимо правильно настроить Adapty SDK с помощью метода Adapty.activate.
BAD_REQUESTНекорректный запрос.
Убедитесь, что вы выполнили все шаги, необходимые для интеграции с Google Play.
SERVER_ERRORОшибка сервера.
REQUEST_FAILEDСетевая ошибка, которую не удаётся точно определить.
DECODING_FAILEDНе удалось декодировать ответ.
Проверьте код и убедитесь, что передаваемые параметры корректны. Например, эта ошибка может указывать на использование недействительного API-ключа.
ANALYTICS_DISABLEDОбработка событий аналитики недоступна, так как вы отключили её.
WRONG_PARAMETERОдин или несколько параметров некорректны: пустое значение там, где оно недопустимо, неверный тип данных и т. д.

Другие проблемы

Если вы ещё не нашли решение, можно попробовать следующее:

  • Обновление SDK до последней версии: мы всегда рекомендуем обновляться до последних версий SDK — они более стабильны и содержат исправления известных проблем.
  • Обратитесь в службу поддержки или получите помощь от других разработчиков на форуме поддержки.
  • Напишите в поддержку на [email protected] или через чат: если вы не готовы обновлять SDK или это не помогло, свяжитесь с нашей командой поддержки. Обратите внимание, что проблема будет решена быстрее, если вы включите подробное логирование и поделитесь логами с командой. Также можно приложить соответствующие фрагменты кода.