--- title: "Xử lý lỗi trong Unity SDK" description: "Xử lý lỗi trong Unity SDK." --- Mọi lỗi được SDK trả về đều là `AdaptyErrorCode`. Dưới đây là một ví dụ: :::tip **Bật verbose logs trước khi debug.** Hầu hết các `AdaptyError` đều bao gồm lỗi gốc từ StoreKit, Play Billing, mạng, hoặc backend. Khi bật verbose logs (`Adapty.SetLogLevel(AdaptyLogLevel.Verbose, ...)` — xem [Logging](sdk-installation-unity#logging)), lỗi gốc đó sẽ được in ra console, thường cho biết nguyên nhân thực sự. ::: :::important Nếu các giải pháp này không khắc phục được vấn đề của bạn, hãy xem [Các vấn đề khác](#other-issues) để biết các bước cần thực hiện trước khi liên hệ hỗ trợ, giúp chúng tôi hỗ trợ bạn hiệu quả hơn. ::: ```csharp showLineNumbers Adapty.MakePurchase(product, (profile, error) => { if (error != null && error.Code == Adapty.ErrorCode.PaymentCancelled) { // payment cancelled } }); ``` ## Mã lỗi StoreKit hệ thống \{#system-storekit-codes\} | Lỗi | Mã | Giải pháp | |-----|----|-----------| | [unknown](https://developer.apple.com/documentation/storekit/skerror/code/unknown) | 0 | Mã lỗi này cho biết đã xảy ra lỗi không xác định hoặc không mong đợi.
Thử lại hoặc xem phần [Các vấn đề khác](#other-issues). | | [clientInvalid](https://developer.apple.com/documentation/storekit/skerror/code/clientinvalid) | 1 | Mã lỗi này cho biết client không được phép thực hiện hành động đang cố gắng. | | [paymentCancelled](https://developer.apple.com/documentation/storekit/skerror/code/paymentcancelled) | 2 |

Mã lỗi này cho biết người dùng đã hủy yêu cầu thanh toán.

Không cần thực hiện hành động nào, nhưng về mặt logic nghiệp vụ, bạn có thể đề xuất ưu đãi cho người dùng hoặc nhắc nhở họ sau.

| | [paymentInvalid](https://developer.apple.com/documentation/storekit/skerror/code/paymentinvalid) | 3 | Lỗi này cho biết một trong các tham số thanh toán không được App Store nhận dạng. | | [paymentNotAllowed](https://developer.apple.com/documentation/storekit/skerror/code/paymentnotallowed) | 4 | Mã lỗi này cho biết người dùng không được phép xác thực thanh toán. | | [storeProductNotAvailable](https://developer.apple.com/documentation/storekit/skerror/code/storeproductnotavailable) | 5 | Mã lỗi này cho biết sản phẩm được yêu cầu không có sẵn trong cửa hàng.
Thử cài lại ứng dụng. | | [cloudServicePermissionDenied](https://developer.apple.com/documentation/storekit/skerror/code/cloudservicepermissiondenied) | 6 | Mã lỗi này cho biết người dùng chưa cho phép truy cập thông tin dịch vụ Cloud. | | [cloudServiceNetworkConnectionFailed](https://developer.apple.com/documentation/storekit/skerror/code/cloudservicenetworkconnectionfailed) | 7 | Mã lỗi này cho biết thiết bị không thể kết nối mạng. | | [cloudServiceRevoked](https://developer.apple.com/documentation/storekit/skerror/code/cloudservicerevoked/) | 8 | Mã lỗi này cho biết người dùng đã thu hồi quyền sử dụng dịch vụ cloud này. | | [privacyAcknowledgementRequired](https://developer.apple.com/documentation/storekit/skerror/code/privacyacknowledgementrequired) | 9 | Mã lỗi này cho biết người dùng chưa xác nhận chính sách quyền riêng tư của Apple. | | [unauthorizedRequestData](https://developer.apple.com/documentation/storekit/skerror/code/unauthorizedrequestdata) | 10 | Mã lỗi này cho biết ứng dụng đang cố sử dụng một thuộc tính mà nó không có quyền truy cập cần thiết. | | [invalidOfferIdentifier](https://developer.apple.com/documentation/storekit/skerror/code/invalidofferidentifier) | 11 |

[`identifier`](https://developer.apple.com/documentation/storekit/skpaymentdiscount/identifier) của ưu đãi không hợp lệ. Ví dụ: bạn chưa thiết lập ưu đãi với identifier đó trong App Store, hoặc bạn đã thu hồi ưu đãi.

Hãy đảm bảo bạn đã thiết lập các ưu đãi mong muốn trong AppStore Connect và truyền vào một offer identifier hợp lệ.

| | [invalidSignature](https://developer.apple.com/documentation/storekit/skerror/code/invalidsignature) | 12 | Mã lỗi này cho biết chữ ký trong payment discount không hợp lệ. | | [missingOfferParams](https://developer.apple.com/documentation/storekit/skerror/code/missingofferparams) | 13 | Mã lỗi này cho biết thiếu các tham số trong payment discount. | | [invalidOfferPrice](https://developer.apple.com/documentation/storekit/skerror/code/invalidofferprice/) | 14 | Mã lỗi này cho biết giá bạn đã chỉ định trong App Store Connect không còn hợp lệ nữa. Các ưu đãi luôn phải thể hiện mức giá giảm. | ## Mã lỗi Android tùy chỉnh \{#custom-android-codes\} | Lỗi | Mã | Giải pháp | |-----|----|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | adaptyNotInitialized | 20 | Bạn cần cấu hình đúng Adapty SDK bằng phương thức `Adapty.activate`. Tìm hiểu cách thực hiện [cho Unity](sdk-installation-unity#activate-adapty-module-of-adapty-sdk). | | productNotFound | 22 | Lỗi này cho biết sản phẩm được yêu cầu mua không có sẵn trong cửa hàng. | | invalidJson | 23 | JSON của paywall không hợp lệ. Hãy sửa trong Adapty Dashboard. Tham khảo phần [Tùy chỉnh paywall với remote config](customize-paywall-with-remote-config) để biết cách khắc phục. | | currentSubscriptionToUpdateNotFoundInHistory | 24 | Không tìm thấy gói đăng ký gốc cần gia hạn. | | pendingPurchase | 25 | Lỗi này cho biết trạng thái giao dịch mua đang ở trạng thái chờ xử lý thay vì đã mua. Tham khảo trang [Handling pending transactions](https://developer.android.com/google/play/billing/integrate#pending) trong tài liệu Android Developer để biết thêm chi tiết. | | billingServiceTimeout | 97 | Lỗi này cho biết yêu cầu đã đạt đến thời gian chờ tối đa trước khi Google Play có thể phản hồi. Nguyên nhân có thể là do chậm trễ trong việc thực thi hành động được yêu cầu bởi lệnh gọi Play Billing Library. | | featureNotSupported | 98 | Tính năng được yêu cầu không được hỗ trợ bởi Play Store trên thiết bị hiện tại. | | billingServiceDisconnected | 99 | Lỗi nghiêm trọng này cho biết kết nối của ứng dụng client tới dịch vụ Google Play Store qua `BillingClient` đã bị ngắt. | | billingServiceUnavailable | 102 | Lỗi tạm thời này cho biết dịch vụ Google Play Billing hiện không khả dụng. Trong hầu hết các trường hợp, điều này có nghĩa là có sự cố kết nối mạng ở đâu đó giữa thiết bị client và dịch vụ Google Play Billing. | | billingUnavailable | 103 |

Lỗi này cho biết đã xảy ra lỗi thanh toán của người dùng trong quá trình mua. Các ví dụ khi điều này có thể xảy ra bao gồm:

1\. Ứng dụng Play Store trên thiết bị của người dùng đã lỗi thời.

2. Người dùng ở quốc gia không được hỗ trợ.

3. Người dùng là người dùng doanh nghiệp và quản trị viên doanh nghiệp của họ đã tắt chức năng mua hàng.

4. Google Play không thể tính phí phương thức thanh toán của người dùng. Ví dụ: thẻ tín dụng của người dùng có thể đã hết hạn.

5. Người dùng chưa đăng nhập vào ứng dụng Play Store.

| | developerError | 105 | Đây là lỗi nghiêm trọng cho biết bạn đang sử dụng API không đúng cách. | | billingError | 106 | Đây là lỗi nghiêm trọng cho biết có vấn đề nội bộ với chính Google Play. | | itemAlreadyOwned | 107 | Sản phẩm consumable này đã được mua. | | itemNotOwned | 108 | Lỗi này cho biết hành động được yêu cầu trên mục đã thất bại vì | ## Mã lỗi StoreKit tùy chỉnh \{#custom-storekit-codes\} | Lỗi | Mã | Giải pháp | |-----|----|-----------| | noProductIDsFound | 1000 |

Lỗi này cho biết không có sản phẩm nào bạn yêu cầu trên paywall có thể mua được trong App Store, dù chúng đã được liệt kê ở đó. Lỗi này đôi khi xuất hiện kèm theo cảnh báo `InvalidProductIdentifiers`. Nếu cảnh báo xuất hiện mà không có lỗi, hãy bỏ qua.

Nếu bạn gặp lỗi này, hãy làm theo các bước trong phần [Khắc phục lỗi Code-1000 `noProductIDsFound`](InvalidProductIdentifiers-unity).

| | productRequestFailed | 1002 |

Không thể tải danh sách sản phẩm khả dụng vào lúc này. Lý do có thể là:

- Chưa có cache nào được tạo và đồng thời không có kết nối internet.

| | cantMakePayments | 1003 | In-app purchase không được phép trên thiết bị này. Xem [hướng dẫn](cantMakePayments-unity) khắc phục. | | noPurchasesToRestore | 1004 | Lỗi này cho biết Google Play không tìm thấy giao dịch mua để khôi phục. | | cantReadReceipt | 1005 |

Không có receipt hợp lệ nào trên thiết bị. Điều này có thể xảy ra khi kiểm thử trong sandbox.

Không cần thực hiện hành động nào, nhưng về mặt logic nghiệp vụ, bạn có thể đề xuất ưu đãi cho người dùng hoặc nhắc nhở họ sau.

| | productPurchaseFailed | 1006 | Giao dịch mua sản phẩm thất bại. Lỗi này bao gồm lỗi gốc từ StoreKit — hãy đọc lỗi được bao gồm (hoặc bật verbose logs để xem trong console) để biết nguyên nhân thực sự. Lỗi được bao gồm thường là một trong các mã StoreKit 0–14 trong bảng trên — phổ biến nhất là `paymentCancelled`, `paymentInvalid`, `paymentNotAllowed`, hoặc `invalidOfferPrice`. Nếu bạn không thể xác định nguyên nhân cụ thể, hãy thử với [sandbox profile](test-purchases-in-sandbox) mới; nếu vẫn thất bại, hãy liên hệ hỗ trợ Apple. | | refreshReceiptFailed | 1010 | Lỗi này cho biết receipt không được nhận. Chỉ áp dụng cho StoreKit 1. | | receiveRestoredTransactionsFailed | 1011 | Khôi phục giao dịch mua thất bại. | ## Mã lỗi mạng tùy chỉnh \{#custom-network-codes\} | Lỗi | Mã | Giải pháp | |:---------------------|:-----|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | notActivated | 2002 | Adapty SDK chưa được kích hoạt.
Thường gặp nhất khi màn hình splash hoặc một script hook sớm gọi các phương thức Adapty trước khi `Adapty.Activate` hoàn tất. Triệu chứng này không ổn định và có thể không tái hiện trong editor vì thời gian trên thiết bị thực khác nhau. Hãy chờ callback hoàn thành của `Activate` trước khi lập lịch bất kỳ lệnh gọi SDK nào khác. Xem [Thứ tự gọi trong Unity SDK](unity-sdk-call-order) để biết trình tự đầy đủ. | | badRequest | 2003 | Yêu cầu không hợp lệ.
Đảm bảo bạn đã hoàn thành tất cả các bước cần thiết để [tích hợp với App Store](app-store-connection-configuration). | | serverError | 2004 | Lỗi máy chủ.
Thử lại sau một khoảng thời gian. Nếu vấn đề vẫn chưa được giải quyết, hãy liên hệ đội hỗ trợ Adapty. | | networkFailed | 2005 | Lỗi này cho biết có sự cố kết nối mạng trên thiết bị của người dùng.
Thử tắt VPN hoặc chuyển từ mạng di động sang WiFi hoặc ngược lại. | | decodingFailed | 2006 | Lỗi này cho biết quá trình giải mã response thất bại.
Kiểm tra lại code và đảm bảo rằng các tham số bạn gửi đều hợp lệ. Ví dụ, lỗi này có thể cho thấy bạn đang sử dụng API key không hợp lệ. | | encodingFailed | 2009 | Lỗi này cho biết quá trình mã hóa request thất bại. | | missingURL | 2010 | URL được yêu cầu là nil. | | analyticsDisabled | 3000 | Chúng tôi không thể xử lý các sự kiện analytics vì bạn đã [tắt tính năng này](analytics-integration#disabling-external-analytics-for-a-specific-customer). | | wrongParam | 3001 | Lỗi này cho biết một số tham số của bạn không chính xác.
Nếu bạn đang sử dụng Adapty paywall builder và không thể hiển thị paywall vì lỗi này, hãy bật **Show on device** trong paywall builder.
Nguyên nhân khác có thể là phiên bản file [fallback](fallback-paywalls) cục bộ không khớp với phiên bản SDK. Hãy tải xuống file mới trong dashboard. | | activateOnceError | 3005 | Không thể gọi phương thức `.activate` nhiều hơn một lần. | | profileWasChanged | 3006 | Hồ sơ người dùng đã bị thay đổi trong quá trình thực hiện thao tác.
Điều này xảy ra khi một phương thức được gọi trong khi `Adapty.Identify` vẫn đang chạy — lệnh gọi đang chạy đó sẽ tác động lên một hồ sơ sắp bị thay thế và SDK từ chối nó. Hãy chờ callback hoàn thành của `Identify` trước bất kỳ lệnh gọi nào liên quan đến hành động của người dùng. Xem [Thứ tự gọi trong Unity SDK](unity-sdk-call-order). | | unsupportedData | 3007 | Lỗi này cho biết định dạng dữ liệu không được SDK hỗ trợ. | | persistingDataError | 3100 | Đã xảy ra lỗi khi lưu dữ liệu. | | fetchTimeoutError | 3101 | Lỗi này cho biết thao tác tải dữ liệu đã hết thời gian chờ. | ## Các vấn đề khác \{#other-issues\} Nếu bạn vẫn chưa tìm được giải pháp, các bước tiếp theo có thể là: - **Nâng cấp SDK lên phiên bản mới nhất**: Chúng tôi luôn khuyến nghị nâng cấp lên phiên bản SDK mới nhất vì chúng ổn định hơn và bao gồm các bản sửa lỗi đã biết. - **Liên hệ đội hỗ trợ hoặc nhận trợ giúp từ cộng đồng nhà phát triển** tại [diễn đàn hỗ trợ](https://adapty.featurebase.app/). - **Liên hệ đội hỗ trợ qua [support@adapty.io](mailto:support@adapty.io) hoặc qua chat**: Nếu bạn chưa sẵn sàng nâng cấp SDK hoặc nâng cấp không giải quyết được vấn đề, hãy liên hệ đội hỗ trợ của chúng tôi. Lưu ý rằng vấn đề của bạn sẽ được giải quyết nhanh hơn nếu bạn [bật verbose logging](sdk-installation-unity#logging) và chia sẻ logs với đội ngũ. Bạn cũng có thể đính kèm các đoạn code liên quan.