XỠlý lỗi trong React Native SDK
Má»—i lá»—i được SDK trả vá» Ä‘á»u có kiểu AdaptyErrorCode. DÆ°á»›i đây là má»™t và dụ:
Báºt verbose logs trÆ°á»›c khi debug. Hầu hết các AdaptyError Ä‘á»u bá»c má»™t lá»—i bên dÆ°á»›i từ StoreKit, Play Billing, network, hoặc backend. Khi báºt verbose logs (adapty.setLogLevel('verbose') — xem phần Logging cho React Native thuần hoặc Expo), lá»—i bá»c đó sẽ được in ra console, thÆ°á»ng cho bạn biết nguyên nhân thá»±c sá»±.
Nếu các giải pháp nà y không giải quyết được vấn đỠcủa bạn, hãy xem phần Các vấn đỠkhác để 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.
try {
const params: MakePurchaseParamsInput = {};
await adapty.makePurchase(product, params);
} catch (error) {
if (
error instanceof AdaptyError &&
error.adaptyCode === getErrorCode(ErrorCode['2'])
) {
// payment cancelled
}
}Mã StoreKit hệ thống
| Lỗi | Mã | Giải pháp |
|---|---|---|
| unknown | 0 | Mã lá»—i cho biết đã xảy ra lá»—i không xác định hoặc bất ngá». Thá» lại hoặc xem phần Các vấn Ä‘á» khác. |
| clientInvalid | 1 | Mã lá»—i nà y cho biết client không được phép thá»±c hiện hà nh Ä‘á»™ng Ä‘ang thá». |
| 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 thêm hà nh Ä‘á»™ng nà o, nhÆ°ng vá» mặt logic kinh doanh, bạn có thể Ä‘á» nghị giảm giá cho ngÆ°á»i dùng hoặc nhắc nhở há» sau. |
| 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 | 4 | Mã lá»—i nà y cho biết ngÆ°á»i dùng không được phép ủy quyá»n thanh toán. |
| 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 đặt lại ứng dụng. |
| 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 | 7 | Mã lỗi nà y cho biết thiết bị không thể kết nối mạng. |
| 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 | 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 | 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 hạn cần thiết. |
| invalidOfferIdentifier | 11 |
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 | 12 | Mã lỗi nà y cho biết chữ ký trong payment discount không hợp lệ. |
| missingOfferParams | 13 | Mã lỗi nà y cho biết thiếu các tham số trong payment discount. |
| 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ệ. Các ưu đãi phải luôn thể hiện mức giá được giảm. |
Mã Android tùy chỉnh
| Lỗi | Mã | Giải pháp |
|---|---|---|
| adaptyNotInitialized | 20 | Bạn cần cấu hình Adapty SDK đúng cách bằng phương thức Adapty.activate. Tìm hiểu cách thực hiện cho React Native. |
| 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. Xem chủ Ä‘á» Tùy chỉnh paywall vá»›i remote config để biết cách sá»a. |
| 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 đang ở trạng thái pending thay vì purchased. Xem trang XỠlý giao dịch 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 timeout tối Ä‘a trÆ°á»›c khi Google Play có thể phản hồi. Nguyên nhân có thể 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 Play Store há»— trợ 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 hà ng. Má»™t số và dụ có thể xảy ra: 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 Ä‘ang ở quốc gia không được há»— trợ. 3. NgÆ°á»i dùng là nhân viên doanh nghiệp và quản trị viên của hỠđã tắt chức năng mua hà ng. 4. Google Play không thể tÃnh phà và o 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ó sá»± cố ná»™i bá»™ vá»›i chÃnh Google Play. |
| itemAlreadyOwned | 107 | Sản phẩm consumable đã được mua trước đó. |
| itemNotOwned | 108 | Lỗi nà y cho biết hà nh động được yêu cầu trên item đã thất bại. |
Mã StoreKit tùy chỉnh
| 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 Ä‘i kèm cảnh báo Nếu bạn gặp lá»—i nà y, hãy là m theo các bÆ°á»›c trong phần Sá»a lá»—i Code-1000 |
| productRequestFailed | 1002 | Không thể tải danh sách sản phẩm khả dụng và o lúc nà y. Nguyên nhân có thể: - 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 khắc phục. |
| noPurchasesToRestore | 1004 | Lỗi nà y cho biết Google Play không tìm thấy giao dịch nà o để 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 trong quá trình kiểm thá» sandbox. Không cần thá»±c hiện thêm hà nh Ä‘á»™ng nà o, nhÆ°ng vá» mặt logic kinh doanh, bạn có thể Ä‘á» nghị giảm giá 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 bá»c má»™t lá»—i StoreKit bên dÆ°á»›i — hãy Ä‘á»c lá»—i bá»c đó (hoặc báºt verbose logs để xem trong console) để biết nguyên nhân thá»±c sá»±. Lá»—i bá»c 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 không xác định được nguyên nhân cụ thể, hãy thá» vá»›i sandbox profile má»›i; nếu vẫn thất bại, hãy liên hệ Apple support. |
| 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 thất bại. |
Mã mạng tùy chỉnh
| 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 UI 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 liên tục và có thể không tái hiện trên simulator vì timing trên thiết bị thá»±c khác nhau. Hãy await activate trÆ°á»›c khi lên lịch bất kỳ lệnh gá»i SDK nà o khác. Xem Thứ tá»± gá»i trong React N ÿÿ ative SDK để 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. |
| serverError | 2004 | Lá»—i máy chủ. Thá» lại sau má»™t 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 sang WiFi từ mạng di Ä‘á»™ng hoặc ngược lại. |
| decodingFailed | 2006 | Lá»—i nà y cho biết giải mã phản hồi thất bại. Hãy xem lại code của bạn và đảm bảo các tham số bạn gá»i Ä‘á»u hợp lệ. Và dụ: lá»—i nà y có thể cho biết bạn Ä‘ang dùng API key không hợp lệ. |
| encodingFailed | 2009 | Lỗi nà y cho biết mã hóa yêu cầu 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. |
| wrongParam | 3001 | Lá»—i nà y cho biết má»™t số tham số của bạn không đúng. Nếu bạn Ä‘ang dùng Paywall Builder của Adapty 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 cục bá»™ không khá»›p vá»›i phiên bản SDK. Hãy tải file má»›i từ 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 đã 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 đó tác Ä‘á»™ng lên má»™t hồ sÆ¡ sắp bị thay thế, và SDK từ chối nó. Hãy luôn await identify trÆ°á»›c bất kỳ lệnh gá»i nà o từ hà nh Ä‘á»™ng của ngÆ°á»i dùng. Xem Thứ tá»± gá»i trong React Native SDK. |
| 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 fetch đã hết thá»i gian chá». |
Các vấn đỠkhác
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 các 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ác nhà phát triển khác trong diá»…n Ä‘Ã n há»— trợ.
- Liên hệ Ä‘á»™i há»— trợ qua support@adapty.io hoặc qua chat: Nếu bạn chÆ°a sẵn sà ng nâng cấp SDK hoặc việ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 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.