--- title: "Обработка ошибок в React Native SDK" description: "Обработка ошибок в React Native SDK." --- Каждая ошибка, возвращаемая SDK, имеет тип `AdaptyErrorCode`. Пример: :::important Если эти решения не помогли, перед обращением в поддержку ознакомьтесь с разделом [Другие проблемы](#other-issues) — это поможет нам быстрее вам помочь. ::: ```typescript showLineNumbers try { const params: MakePurchaseParamsInput = {}; await adapty.makePurchase(product, params); } catch (error) { if ( error instanceof AdaptyError && error.adaptyCode === getErrorCode(ErrorCode['2']) ) { // payment cancelled } } ``` ## Системные коды 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 | Этот код ошибки означает, что приложение пытается использовать свойство, для которого у него нет необходимых прав доступа. | | [invalidOfferIdentifier](https://developer.apple.com/documentation/storekit/skerror/code/invalidofferidentifier) | 11 |

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

Убедитесь, что нужные предложения настроены в AppStore 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`. Узнайте, как это сделать [для React Native](sdk-installation-reactnative). | | productNotFound | 22 | Эта ошибка означает, что запрошенный для покупки продукт недоступен в сторе. | | invalidJson | 23 | JSON пейвола невалиден. Исправьте его в дашборде Adapty. Подробнее см. в разделе [Настройка пейвола с помощью Remote Config](customize-paywall-with-remote-config). | | currentSubscriptionToUpdateNotFoundInHistory | 24 | Исходная подписка, которую нужно продлить, не найдена. | | pendingPurchase | 25 | Эта ошибка означает, что покупка находится в состоянии ожидания, а не завершена. Подробнее см. на странице [Handling pending transactions](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-react-native).

| | productRequestFailed | 1002 |

Не удалось получить список доступных продуктов. Возможная причина:

- Кэш ещё не создан, и одновременно отсутствует интернет-соединение.

| | cantMakePayments | 1003 | Встроенные покупки запрещены на этом устройстве. Смотрите [гайд](cantMakePayments-react-native) по устранению неполадок. | | noPurchasesToRestore | 1004 | Эта ошибка означает, что Google Play не нашёл покупку для восстановления. | | cantReadReceipt | 1005 |

На устройстве нет действующего чека. Это может возникать при тестировании в песочнице.

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

| | productPurchaseFailed | 1006 | Не удалось совершить покупку продукта. | | refreshReceiptFailed | 1010 | Эта ошибка означает, что чек не был получен. Применимо только к StoreKit 1. | | receiveRestoredTransactionsFailed | 1011 | Не удалось восстановить покупки. | ## Пользовательские сетевые коды \{#custom-network-codes\} | Ошибка | Код | Решение | | :------------------- | :--- |:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | notActivated | 2002 | Adapty SDK не активирован. Необходимо правильно [настроить Adapty SDK](sdk-installation-reactnative) с помощью метода `Adapty.activate`. | | badRequest | 2003 | Некорректный запрос.
Убедитесь, что вы выполнили все шаги для [интеграции с App Store](app-store-connection-configuration). | | serverError | 2004 | Ошибка сервера.
Повторите попытку через некоторое время. Если проблема не решается, обратитесь в службу поддержки Adapty. | | networkFailed | 2005 | Ошибка указывает на проблемы с сетевым подключением на устройстве пользователя.
Попробуйте отключить VPN или переключиться с мобильной сети на Wi-Fi или наоборот. | | decodingFailed | 2006 | Ошибка указывает на сбой декодирования ответа.
Проверьте код и убедитесь, что передаваемые параметры корректны. Например, эта ошибка может означать использование недействительного API-ключа. | | encodingFailed | 2009 | Ошибка указывает на сбой кодирования запроса. | | missingURL | 2010 | Запрошенный URL равен nil. | | 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-reactnative) и поделитесь логами с командой. Также можно приложить соответствующие фрагменты кода.