--- title: "Unity SDK'da hataları yönetme" description: "Unity SDK'da hataları yönetme." --- SDK tarafından döndürülen her hata `AdaptyErrorCode` türündedir. İşte bir örnek: :::important Bu çözümler sorununuzu gidermezse, destek ekibiyle iletişime geçmeden önce atmanız gereken adımlar için [Diğer sorunlar](#other-issues) bölümüne bakın; bu, size daha hızlı yardımcı olmamızı sağlar. ::: ```csharp showLineNumbers Adapty.MakePurchase(product, (profile, error) => { if (error != null && error.Code == Adapty.ErrorCode.PaymentCancelled) { // payment cancelled } }); ``` ## Sistem StoreKit Kodları \{#system-storekit-codes\} | Hata | Kod | Çözüm | |-----|----|-----------| | [unknown](https://developer.apple.com/documentation/storekit/skerror/code/unknown) | 0 | Bilinmeyen veya beklenmedik bir hata oluştuğunu gösteren hata kodu.
Tekrar deneyin veya [Diğer sorunlar](#other-issues) bölümüne bakın. | | [clientInvalid](https://developer.apple.com/documentation/storekit/skerror/code/clientinvalid) | 1 | İstemcinin gerçekleştirmeye çalıştığı işleme izin verilmediğini gösteren hata kodu. | | [paymentCancelled](https://developer.apple.com/documentation/storekit/skerror/code/paymentcancelled) | 2 |

Kullanıcının ödeme isteğini iptal ettiğini gösteren hata kodu.

Herhangi bir işlem yapmanıza gerek yok; ancak iş mantığı açısından kullanıcıya indirim teklif edebilir ya da daha sonra hatırlatma yapabilirsiniz.

| | [paymentInvalid](https://developer.apple.com/documentation/storekit/skerror/code/paymentinvalid) | 3 | Ödeme parametrelerinden birinin App Store tarafından tanınmadığını gösteren hata kodu. | | [paymentNotAllowed](https://developer.apple.com/documentation/storekit/skerror/code/paymentnotallowed) | 4 | Kullanıcının ödeme yapmasına izin verilmediğini gösteren hata kodu. | | [storeProductNotAvailable](https://developer.apple.com/documentation/storekit/skerror/code/storeproductnotavailable) | 5 | İstenen ürünün mağazada mevcut olmadığını gösteren hata kodu.
Uygulamayı yeniden yüklemeyi deneyin. | | [cloudServicePermissionDenied](https://developer.apple.com/documentation/storekit/skerror/code/cloudservicepermissiondenied) | 6 | Kullanıcının bulut hizmeti bilgilerine erişime izin vermediğini gösteren hata kodu. | | [cloudServiceNetworkConnectionFailed](https://developer.apple.com/documentation/storekit/skerror/code/cloudservicenetworkconnectionfailed) | 7 | Cihazın ağa bağlanamadığını gösteren hata kodu. | | [cloudServiceRevoked](https://developer.apple.com/documentation/storekit/skerror/code/cloudservicerevoked/) | 8 | Kullanıcının bu bulut hizmetini kullanma iznini iptal ettiğini gösteren hata kodu. | | [privacyAcknowledgementRequired](https://developer.apple.com/documentation/storekit/skerror/code/privacyacknowledgementrequired) | 9 | Kullanıcının Apple'ın gizlilik politikasını henüz onaylamadığını gösteren hata kodu. | | [unauthorizedRequestData](https://developer.apple.com/documentation/storekit/skerror/code/unauthorizedrequestdata) | 10 | Uygulamanın gerekli yetkiye sahip olmadığı bir özelliği kullanmaya çalıştığını gösteren hata kodu. | | [invalidOfferIdentifier](https://developer.apple.com/documentation/storekit/skerror/code/invalidofferidentifier) | 11 |

Teklif [`identifier`](https://developer.apple.com/documentation/storekit/skpaymentdiscount/identifier)'ı geçerli değil. Örneğin App Store'da bu tanımlayıcıya sahip bir teklif oluşturmamış ya da teklifi iptal etmiş olabilirsiniz.

İstediğiniz teklifleri AppStore Connect'te ayarladığınızdan ve geçerli bir teklif tanımlayıcısı geçirdiğinizden emin olun.

| | [invalidSignature](https://developer.apple.com/documentation/storekit/skerror/code/invalidsignature) | 12 | Ödeme indirimindeki imzanın geçerli olmadığını gösteren hata kodu. | | [missingOfferParams](https://developer.apple.com/documentation/storekit/skerror/code/missingofferparams) | 13 | Ödeme indiriminde parametrelerin eksik olduğunu gösteren hata kodu. | | [invalidOfferPrice](https://developer.apple.com/documentation/storekit/skerror/code/invalidofferprice/) | 14 | App Store Connect'te belirttiğiniz fiyatın artık geçerli olmadığını gösteren hata kodu. Teklifler her zaman indirimli bir fiyatı temsil etmelidir. | ## Özel Android Kodları \{#custom-android-codes\} | Hata | Kod | Çözüm | |-----|----|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | adaptyNotInitialized | 20 | Adapty SDK'yı `Adapty.activate` metoduyla düzgün şekilde yapılandırmanız gerekiyor. Nasıl yapacağınızı öğrenmek için [Unity için](sdk-installation-unity#activate-adapty-module-of-adapty-sdk) ilgili sayfaya bakın. | | productNotFound | 22 | Bu hata, satın alma için istenen ürünün mağazada mevcut olmadığını gösterir. | | invalidJson | 23 | Paywall JSON'ı geçerli değil. Adapty Kontrol Paneli'nden düzeltin. Nasıl düzelteceğinizi öğrenmek için [Paywall'u remote config ile özelleştirme](customize-paywall-with-remote-config) konusuna bakın. | | currentSubscriptionToUpdateNotFoundInHistory | 24 | Yenilenmesi gereken orijinal abonelik geçmişte bulunamadı. | | pendingPurchase | 25 | Bu hata, satın alma durumunun tamamlandı yerine beklemede olduğunu gösterir. Ayrıntılar için Android Developer belgelerindeki [Bekleyen işlemleri yönetme](https://developer.android.com/google/play/billing/integrate#pending) sayfasına bakın. | | billingServiceTimeout | 97 | Bu hata, Google Play yanıt vermeden önce isteğin maksimum zaman aşımına ulaştığını gösterir. Bu durum, örneğin Play Billing Library çağrısı tarafından istenen işlemin gecikmesinden kaynaklanabilir. | | featureNotSupported | 98 | İstenen özellik, mevcut cihazda Play Store tarafından desteklenmiyor. | | billingServiceDisconnected | 99 | Bu kritik hata, istemci uygulamanın `BillingClient` aracılığıyla Google Play Store hizmetiyle kurduğu bağlantının kesildiğini gösterir. | | billingServiceUnavailable | 102 | Bu geçici hata, Google Play Billing hizmetinin şu anda kullanılamadığını gösterir. Çoğu durumda bu, istemci cihaz ile Google Play Billing hizmetleri arasında bir ağ bağlantısı sorunu olduğu anlamına gelir. | | billingUnavailable | 103 |

Bu hata, satın alma işlemi sırasında kullanıcı kaynaklı bir faturalandırma hatası oluştuğunu gösterir. Bu hatanın oluşabileceği durumlar şunlardır:

1\. Kullanıcının cihazındaki Play Store uygulaması güncel değil.

2. Kullanıcı desteklenmeyen bir ülkede.

3. Kullanıcı bir kurumsal kullanıcı ve kurumsal yöneticisi satın alma işlemlerini devre dışı bırakmış.

4. Google Play, kullanıcının ödeme yöntemini tahsil edemiyor. Örneğin, kullanıcının kredi kartının süresi dolmuş olabilir.

5. Kullanıcı Play Store uygulamasına giriş yapmamış.

| | developerError | 105 | Bu, bir API'yi hatalı kullandığınızı gösteren kritik bir hatadır. | | billingError | 106 | Bu, Google Play'in kendi içinde bir sorun olduğunu gösteren kritik bir hatadır. | | itemAlreadyOwned | 107 | Consumable ürün zaten satın alınmış. | | itemNotOwned | 108 | Bu hata, öğe üzerinde istenen işlemin başarısız olduğunu gösterir. | ## Özel StoreKit kodları \{#custom-storekit-codes\} | Hata | Kod | Çözüm | |-----|----|-----------| | noProductIDsFound | 1000 |

Bu hata, paywall'da talep ettiğiniz ürünlerin App Store'da listelenmesine rağmen satın alma için mevcut olmadığını gösterir. Bazen bu hatayla birlikte `InvalidProductIdentifiers` uyarısı da gelebilir. Uyarı hatasız geliyorsa görmezden gelebilirsiniz.

Bu hatayla karşılaşıyorsanız [Kod-1000 `noProductIDsFound` hatasının çözümü](InvalidProductIdentifiers-unity) bölümündeki adımları izleyin.

| | productRequestFailed | 1002 |

Şu anda mevcut ürünler alınamıyor. Olası neden:

- Henüz önbellek oluşturulmamış ve aynı anda internet bağlantısı da yok.

| | cantMakePayments | 1003 | Bu cihazda Uygulama İçi satın almalar izin verilmiyor. Sorun giderme [kılavuzuna](cantMakePayments-unity) bakın. | | noPurchasesToRestore | 1004 | Bu hata, Google Play'in geri yüklenecek satın almayı bulamadığını gösterir. | | cantReadReceipt | 1005 |

Cihazda geçerli bir makbuz yok. Bu durum sandbox testleri sırasında yaşanabilir.

Herhangi bir işlem yapmanıza gerek yok; ancak iş mantığı açısından kullanıcıya indirim teklif edebilir ya da daha sonra hatırlatabilirsiniz.

| | productPurchaseFailed | 1006 | Ürün satın alımı başarısız oldu. | | refreshReceiptFailed | 1010 | Bu hata, makbuzun alınamadığını gösterir. Yalnızca StoreKit 1 için geçerlidir. | | receiveRestoredTransactionsFailed | 1011 | Satın alma geri yükleme başarısız oldu. | ## Özel ağ kodları \{#custom-network-codes\} | Hata | Kod | Çözüm | |:---------------------|:-----|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | notActivated | 2002 | Adapty SDK etkinleştirilmemiş. SDK'yı `Adapty.activate` metodunu kullanarak düzgün şekilde [yapılandırmanız](sdk-installation-unity#activate-adapty-module-of-adapty-sdk) gerekiyor. | | badRequest | 2003 | Hatalı istek.
[App Store entegrasyonu](app-store-connection-configuration) için gerekli tüm adımları tamamladığınızdan emin olun. | | serverError | 2004 | Sunucu hatası.
Bir süre sonra tekrar deneyin. Sorun devam ederse Adapty destek ekibiyle iletişime geçin. | | networkFailed | 2005 | Bu hata, kullanıcının cihazındaki ağ bağlantısıyla ilgili sorunları gösterir.
VPN'i devre dışı bırakmayı ya da mobil ağdan WiFi'ye (veya tersine) geçmeyi deneyin. | | decodingFailed | 2006 | Bu hata, yanıt çözümlemesinin başarısız olduğunu gösterir.
Kodunuzu gözden geçirin ve gönderdiğiniz parametrelerin geçerli olduğundan emin olun. Örneğin bu hata, geçersiz bir API anahtarı kullandığınızı gösterebilir. | | encodingFailed | 2009 | Bu hata, istek kodlamasının başarısız olduğunu gösterir. | | missingURL | 2010 | İstenen URL nil. | | analyticsDisabled | 3000 | [Devre dışı bıraktığınız](analytics-integration#disabling-external-analytics-for-a-specific-customer) için analitik olayları işleyemiyoruz. | | wrongParam | 3001 | Bu hata, bazı parametrelerinizin doğru olmadığını gösterir.
Adapty paywall builder kullanıyorsanız ve bu hata nedeniyle paywall gösteremiyorsanız, paywall builder'da **Show on device** seçeneğini etkinleştirin.
Bir diğer olası neden, yerel [yedek](fallback-paywalls) dosya sürümünün SDK sürümüyle eşleşmemesidir. Kontrol panelinden yeni bir dosya indirin. | | activateOnceError | 3005 | `.activate` metodu birden fazla kez çağrılamaz. | | profileWasChanged | 3006 | İşlem sırasında kullanıcı profili değişti.
Bu hata, `identify` çağrısından hemen sonra `identify` tamamlanmadan başka bir metot çağırdığınızda oluşabilir. Bunu önlemek için diğer metotları çağırmadan önce `identify` işleminin tamamlanmasını bekleyin. | | unsupportedData | 3007 | Bu hata, veri formatının SDK tarafından desteklenmediğini gösterir. | | persistingDataError | 3100 | Veri kaydedilirken bir hata oluştu. | | fetchTimeoutError | 3101 | Bu hata, veri çekme işleminin zaman aşımına uğradığını gösterir. | ## Diğer sorunlar \{#other-issues\} Henüz bir çözüm bulamadıysanız, deneyebileceğiniz sonraki adımlar şunlardır: - **SDK'yı en son sürüme yükseltin**: En son SDK sürümleri daha kararlı olduğundan ve bilinen sorunlara yönelik düzeltmeler içerdiğinden, her zaman güncellemenizi öneririz. - **Destek ekibiyle iletişime geçin veya diğer geliştiricilerden yardım alın**: [Destek forumu](https://adapty.featurebase.app/)ndan diğer geliştiricilerle iletişime geçebilirsiniz. - **Destek ekibiyle [support@adapty.io](mailto:support@adapty.io) adresinden veya sohbet üzerinden iletişime geçin**: SDK'yı yükseltmeye hazır değilseniz veya bu işlem sorunu çözmediyse destek ekibimize başvurun. [Ayrıntılı günlük kaydını etkinleştirip](sdk-installation-unity#logging) günlükleri ekiple paylaşırsanız sorununuz daha hızlı çözülecektir. İlgili kod parçacıklarını da ekleyebilirsiniz.