--- title: "Обработка ошибок в Flutter SDK" description: "Обработка ошибок в Flutter SDK." --- Каждая ошибка, возвращаемая SDK, имеет тип `AdaptyErrorCode`. Пример: :::important Если эти решения не помогли, перед обращением в поддержку ознакомьтесь с разделом [Другие проблемы](#other-issues) — это поможет нам быстрее разобраться в ситуации. ::: ```javascript showLineNumbers try { final result = await adapty.makePurchase(product: product); } on AdaptyError catch (adaptyError) { if (adaptyError.code == AdaptyErrorCode.paymentCancelled) { // Cancelled } } catch (e) { } ``` ## Системные коды StoreKit \{#system-storekit-codes\} | Ошибка | Код | Решение | |-----|----|-----------| | [unknown](https://developer.apple.com/documentation/storekit/skerror/code/unknown) | 0 | Неизвестная или непредвиденная ошибка.
Попробуйте повторить запрос или обратитесь к разделу [Другие проблемы](#other-issues). | | [clientInvalid](https://developer.apple.com/documentation/storekit/skerror/code/clientinvalid) | 1 | Клиент не имеет права выполнять это действие. | | [paymentCancelled](https://developer.apple.com/documentation/storekit/skerror/code/paymentcancelled) | 2 |

Пользователь отменил запрос на оплату.

Никаких действий не требуется, однако с точки зрения бизнес-логики вы можете предложить скидку или напомнить о покупке позже.

| | [paymentInvalid](https://developer.apple.com/documentation/storekit/skerror/code/paymentinvalid) | 3 | Один из параметров платежа не был распознан App Store. | | [paymentNotAllowed](https://developer.apple.com/documentation/storekit/skerror/code/paymentnotallowed) | 4 | Пользователь не имеет права подтверждать платежи. | | [storeProductNotAvailable](https://developer.apple.com/documentation/storekit/skerror/code/storeproductnotavailable) | 5 | Запрошенный продукт недоступен в сторе.
Попробуйте переустановить приложение. | | [cloudServicePermissionDenied](https://developer.apple.com/documentation/storekit/skerror/code/cloudservicepermissiondenied) | 6 | Пользователь не разрешил доступ к информации об облачном сервисе. | | [cloudServiceNetworkConnectionFailed](https://developer.apple.com/documentation/storekit/skerror/code/cloudservicenetworkconnectionfailed) | 7 | Устройству не удалось подключиться к сети. | | [cloudServiceRevoked](https://developer.apple.com/documentation/storekit/skerror/code/cloudservicerevoked/) | 8 | Пользователь отозвал разрешение на использование этого облачного сервиса. | | [privacyAcknowledgementRequired](https://developer.apple.com/documentation/storekit/skerror/code/privacyacknowledgementrequired) | 9 | Пользователь ещё не принял политику конфиденциальности Apple. | | [unauthorizedRequestData](https://developer.apple.com/documentation/storekit/skerror/code/unauthorizedrequestdata) | 10 | Приложение пытается использовать свойство, для которого у него нет необходимого entitlement. | | [invalidOfferIdentifier](https://developer.apple.com/documentation/storekit/skerror/code/invalidofferidentifier) | 11 |

[`Идентификатор`](https://developer.apple.com/documentation/storekit/skpaymentdiscount/identifier) предложения недействителен. Например, предложение с таким идентификатором не создано в App Store или было отозвано.

Убедитесь, что нужные предложения настроены в App Store Connect, и передайте корректный идентификатор предложения.

| | [invalidSignature](https://developer.apple.com/documentation/storekit/skerror/code/invalidsignature) | 12 | Подпись в скидке на платёж недействительна. | | [missingOfferParams](https://developer.apple.com/documentation/storekit/skerror/code/missingofferparams) | 13 | В скидке на платёж отсутствуют обязательные параметры. | | [invalidOfferPrice](https://developer.apple.com/documentation/storekit/skerror/code/invalidofferprice/) | 14 | Цена, указанная в App Store Connect, больше не является действительной. Предложения всегда должны предусматривать скидку от обычной цены. | ## Пользовательские коды Android \{#custom-android-codes\} | Ошибка | Код | Решение | |-----|----|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | adaptyNotInitialized | 20 | Необходимо правильно настроить Adapty SDK с помощью метода `Adapty.activate`. Узнайте, как это сделать [для Flutter](sdk-installation-flutter#activate-adapty-module-of-adapty-sdk). | | productNotFound | 22 | Эта ошибка означает, что запрошенный для покупки продукт недоступен в сторе. | | invalidJson | 23 | JSON пейвола недействителен. Исправьте его в дашборде Adapty. Подробнее о том, как это сделать, читайте в разделе [Настройка пейвола с помощью Remote Config](customize-paywall-with-remote-config). | | currentSubscriptionToUpdateNotFoundInHistory | 24 | Исходная подписка, которую необходимо продлить, не найдена. | | pendingPurchase | 25 | Эта ошибка означает, что покупка находится в состоянии ожидания, а не завершена. Подробнее читайте на странице [Обработка отложенных транзакций](https://developer.android.com/google/play/billing/integrate#pending) в документации Android Developer. | | billingServiceTimeout | 97 | Эта ошибка означает, что запрос достиг максимального таймаута до того, как Google Play смог ответить. Причиной может быть, например, задержка при выполнении действия, запрошенного вызовом Play Billing Library. | | featureNotSupported | 98 | Запрошенная функция не поддерживается Play Store на данном устройстве. | | billingServiceDisconnected | 99 | Эта критическая ошибка означает, что соединение клиентского приложения с сервисом Google Play Store через `BillingClient` было разорвано. | | billingServiceUnavailable | 102 | Эта временная ошибка означает, что сервис Google Play Billing в данный момент недоступен. В большинстве случаев это связано с проблемой сетевого подключения между клиентским устройством и сервисами Google Play Billing. | | billingUnavailable | 103 |

Эта ошибка означает, что в процессе покупки возникла ошибка биллинга на стороне пользователя. Примеры возможных причин:

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

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

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

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

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

| | developerError | 105 | Это критическая ошибка, указывающая на некорректное использование API. | | billingError | 106 | Это критическая ошибка, указывающая на внутреннюю проблему самого Google Play. | | itemAlreadyOwned | 107 | Расходуемая покупка уже была приобретена. | | itemNotOwned | 108 | Эта ошибка означает, что запрошенное действие над элементом не удалось выполнить, поскольку он не принадлежит пользователю. | ## Пользовательские коды StoreKit \{#custom-storekit-codes\} | Ошибка | Код | Решение | |-----------------------------------------------------------------------------------------------------|------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | noProductIDsFound | 1000 |

Эта ошибка означает, что ни один из продуктов, запрошенных на пейволе, недоступен для покупки в App Store, хотя они там и перечислены. Иногда ошибка сопровождается предупреждением `InvalidProductIdentifiers`. Если предупреждение появляется без ошибки — игнорируйте его.

Если вы столкнулись с этой ошибкой, следуйте инструкциям в разделе [Исправление ошибки Code-1000 `noProductIDsFound`](InvalidProductIdentifiers-flutter).

| | noProductsFound | 1001 | Эта ошибка означает, что продукт, запрошенный для покупки, недоступен в сторе. | | productRequestFailed | 1002 | Не удалось получить список доступных продуктов. | | cantMakePayments | 1003 | Встроенные покупки запрещены на этом устройстве. См. [гайд](cantMakePayments-flutter) по устранению неполадок. | | noPurchasesToRestore | 1004 | Эта ошибка означает, что App Store не нашёл покупку для восстановления. | | [cantReadReceipt](https://developer.apple.com/documentation/storekit/skerror/code/paymentcancelled) | 1005 |

На устройстве нет действительного чека. Это может быть проблемой при тестировании в песочнице.

В песочнице действительный файл чека появляется только после реальной покупки — убедитесь, что совершили её перед обращением к нему. При тестировании в песочнице также убедитесь, что вошли на устройстве с действительным аккаунтом Apple Sandbox.

| | productPurchaseFailed | 1006 | Покупка продукта не удалась. Ошибка StoreKit, не связанная с Adapty. Попробуйте использовать новый [профиль песочницы](test-purchases-in-sandbox). Если это не поможет, обратитесь в поддержку Apple. | | missingOfferSigningParams | 1007 |

Эта ошибка указывает на проблемы с интеграцией Adapty или с офферами.

Подробнее о настройке см. в разделах [Настройка интеграции с App Store](app-store-connection-configuration) и [Офферы](offers).

| | refreshReceiptFailed | 1010 | Эта ошибка означает, что чек не был получен. Применимо только к StoreKit 1. | | receiveRestoredTransactionsFailed | 1011 | Не удалось восстановить покупки. | ## Пользовательские сетевые коды \{#custom-network-codes\} | Ошибка | Код | Решение | | :------------------- | :--- |:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | notActivated | 2002 | Adapty SDK не активирован. Необходимо правильно [настроить Adapty SDK](sdk-installation-flutter#activate-adapty-module-of-adapty-sdk) с помощью метода `Adapty.activate`. | | badRequest | 2003 | Некорректный запрос.
Убедитесь, что вы выполнили все шаги, необходимые для [интеграции с App Store](app-store-connection-configuration). | | serverError | 2004 | Ошибка сервера.
Повторите попытку через некоторое время. Если проблема не устранена, обратитесь в службу поддержки Adapty. | | networkFailed | 2005 | Ошибка указывает на проблемы с сетевым подключением на устройстве пользователя.
Попробуйте отключить VPN или переключиться с мобильной сети на Wi-Fi или наоборот. | | decodingFailed | 2006 | Ошибка указывает на сбой декодирования ответа.
Проверьте свой код и убедитесь, что передаваемые параметры корректны. Например, эта ошибка может означать, что вы используете неверный API-ключ. | | encodingFailed | 2009 | Ошибка указывает на сбой кодирования запроса. | | analyticsDisabled | 3000 | Обработка аналитических событий невозможна, так как вы [отключили её](analytics-integration#disabling-external-analytics-for-a-specific-customer). | | wrongParam | 3001 | Ошибка указывает на то, что один или несколько параметров заданы неверно.
Если вы используете Paywall Builder и не можете отобразить пейвол из-за этой ошибки, включите **Show on device** в Paywall Builder.
Ещё одна возможная причина — версия локального файла [резервного пейвола](fallback-paywalls) не совпадает с версией SDK. Загрузите новый файл в дашборде. | | activateOnceError | 3005 | Метод `.activate` нельзя вызывать более одного раза. | | profileWasChanged | 3006 | Профиль пользователя был изменён в ходе операции.
Эта ошибка может возникнуть, если вы вызываете `identify`, а затем вызываете другой метод до завершения `identify`. Чтобы избежать этого, дождитесь успешного выполнения `identify` перед вызовом других методов. | | unsupportedData | 3007 | Ошибка указывает на то, что формат данных не поддерживается SDK. | | persistingDataError | 3100 | Произошла ошибка при сохранении данных. | | fetchTimeoutError | 3101 | Ошибка указывает на превышение времени ожидания операции получения данных. | ## Другие проблемы \{#other-issues\} Если вы ещё не нашли решение, попробуйте следующее: - **Обновление SDK до последней версии**: мы всегда рекомендуем обновляться до последних версий SDK, так как они более стабильны и содержат исправления известных проблем. - **Обратитесь в службу поддержки или получите помощь от других разработчиков** на [форуме поддержки](https://adapty.featurebase.app/). - **Обратитесь в службу поддержки по адресу [support@adapty.io](mailto:support@adapty.io) или через чат**: если вы не готовы обновить SDK или это не помогло, свяжитесь с нашей командой поддержки. Обратите внимание, что проблема будет решена быстрее, если вы [включите подробное логирование](sdk-installation-flutter#logging) и поделитесь логами с командой. Вы также можете приложить соответствующие фрагменты кода.