Gestionar errores en el SDK de React Native
Todos los errores que devuelve el SDK son de tipo AdaptyErrorCode. A continuación tienes un ejemplo:
Activa los logs detallados antes de depurar. La mayoría de los AdaptyError envuelven un error subyacente de StoreKit, Play Billing, red o backend. Con los logs detallados activados (adapty.setLogLevel('verbose') — consulta Logging para RN puro o Expo), ese error interno se imprime en la consola, lo que normalmente indica la causa real.
Si estas soluciones no resuelven tu problema, consulta Otros problemas para conocer los pasos a seguir antes de contactar con soporte y ayudarnos a asistirte de forma más eficiente.
try {
const params: MakePurchaseParamsInput = {};
await adapty.makePurchase(product, params);
} catch (error) {
if (
error instanceof AdaptyError &&
error.adaptyCode === getErrorCode('cantMakePayments')
) {
// Las compras in-app no están permitidas en este dispositivo
}
}error.adaptyCode es un número, así que compáralo con un número: ya sea un literal (1003) o el resultado de getErrorCode('<name>'). ErrorCode funciona en sentido contrario — de un número a su nombre — así que úsalo para registrar logs, no para comparar.
Una compra cancelada por el usuario no es un error. makePurchase resuelve con un AdaptyPurchaseResult cuyo type es 'user_cancelled' — consulta Realizar compras.
Códigos del sistema StoreKit
| Error | Código | Solución |
|---|---|---|
| unknown | 0 | Código de error que indica que ocurrió un error desconocido o inesperado. Reintenta o consulta la sección Otros problemas. |
| clientInvalid | 1 | Este código de error indica que el cliente no tiene permiso para realizar la acción solicitada. |
| paymentCancelled | 2 | Este código de error indica que el usuario canceló una solicitud de pago. No se requiere ninguna acción, aunque desde el punto de vista del negocio puedes ofrecer un descuento al usuario o recordárselo más adelante. |
| paymentInvalid | 3 | Este error indica que uno de los parámetros de pago no fue reconocido por el App Store. |
| paymentNotAllowed | 4 | Este código de error indica que el usuario no tiene permiso para autorizar pagos. |
| storeProductNotAvailable | 5 | Este código de error indica que el producto solicitado no está disponible en el store. Intenta reinstalar la app. |
| cloudServicePermissionDenied | 6 | Este código de error indica que el usuario no ha permitido el acceso a la información del servicio en la nube. |
| cloudServiceNetworkConnectionFailed | 7 | Este código de error indica que el dispositivo no pudo conectarse a la red. |
| cloudServiceRevoked | 8 | Este código de error indica que el usuario ha revocado el permiso para usar este servicio en la nube. |
| privacyAcknowledgementRequired | 9 | Este código de error indica que el usuario aún no ha aceptado la política de privacidad de Apple. |
| unauthorizedRequestData | 10 | Este código de error indica que la app está intentando usar una propiedad para la que no tiene el entitlement necesario. |
| invalidOfferIdentifier | 11 | El Asegúrate de configurar las ofertas deseadas en App Store Connect y de pasar un identificador de oferta válido. |
| invalidSignature | 12 | Este código de error indica que la firma en un descuento de pago no es válida. |
| missingOfferParams | 13 | Este código de error indica que faltan parámetros en un descuento de pago. |
| invalidOfferPrice | 14 | Este código de error indica que el precio especificado en App Store Connect ya no es válido. Las ofertas siempre deben representar un precio con descuento. |
Códigos de Android personalizados
| Error | Código | Solución |
|---|---|---|
| adaptyNotInitialized | 20 | Necesitas configurar correctamente el SDK de Adapty mediante el método Adapty.activate. Aprende cómo hacerlo para React Native. |
| productNotFound | 22 | Este error indica que el producto solicitado para la compra no está disponible en el store. |
| currentSubscriptionToUpdateNotFoundInHistory | 24 | No se encuentra la suscripción original que debe renovarse. |
| billingServiceTimeout | 97 | Este error indica que la solicitud alcanzó el tiempo de espera máximo antes de que Google Play pudiera responder. Esto puede deberse, por ejemplo, a un retraso en la ejecución de la acción solicitada por la llamada a la Play Billing Library. |
| featureNotSupported | 98 | La función solicitada no es compatible con Play Store en el dispositivo actual. |
| billingServiceDisconnected | 99 | Este error fatal indica que la conexión de la app cliente con el servicio de Google Play Store a través de BillingClient se ha interrumpido. |
| billingServiceUnavailable | 102 | Este error transitorio indica que el servicio Google Play Billing no está disponible en este momento. En la mayoría de los casos, significa que hay un problema de conexión de red en algún punto entre el dispositivo cliente y los servicios de Google Play Billing. |
| billingUnavailable | 103 | Este error indica que se produjo un error de facturación del usuario durante el proceso de compra. Algunos ejemplos de cuándo puede ocurrir: 1. La app de Play Store en el dispositivo del usuario está desactualizada. 2. El usuario se encuentra en un país no compatible. 3. El usuario es un usuario empresarial y su administrador ha deshabilitado las compras. 4. Google Play no puede cobrar el método de pago del usuario. Por ejemplo, la tarjeta de crédito del usuario puede haber expirado. 5. El usuario no ha iniciado sesión en la app de Play Store. |
| developerError | 105 | Este es un error fatal que indica que estás usando una API de forma incorrecta. |
| billingError | 106 | Este es un error fatal que indica un problema interno en Google Play. |
| itemAlreadyOwned | 107 | El producto consumible ya ha sido comprado. |
| itemNotOwned | 108 | Este error indica que la acción solicitada sobre el artículo falló sin |
| billingNetworkError | 112 | Este error indica que hubo un problema con la conexión de red entre el dispositivo y los sistemas de Play. |
Códigos personalizados de StoreKit
| Error | Código | Solución |
|---|---|---|
| noProductIDsFound | 1000 | Este error indica que ninguno de los productos que solicitaste en el paywall está disponible para comprar en el App Store, aunque estén listados allí. A veces puede aparecer junto con una advertencia Si encuentras este error, sigue los pasos de la sección Fix for Code-1000 |
| productRequestFailed | 1002 | No se pueden obtener los productos disponibles en este momento. Posible causa: - No se ha creado ninguna caché todavía y tampoco hay conexión a internet. |
| cantMakePayments | 1003 | Las compras in-app no están permitidas en este dispositivo. Consulta la guía de resolución de problemas. |
| noPurchasesToRestore | 1004 | Obsoleto en Adapty React Native SDK 4.0.3: restorePurchases() ya no devuelve este error. Cuando no hay nada que restaurar, el método resuelve con el perfil actual, así que comprueba el estado del nivel de acceso en él. En versiones anteriores del SDK, este error indica que Google Play no encontró la compra a restaurar. |
| cantReadReceipt | 1005 | No hay ningún recibo válido disponible en el dispositivo. Esto puede ser un problema durante las pruebas en sandbox. No se requiere ninguna acción, pero en términos de lógica de negocio, puedes ofrecer un descuento a tu usuario o recordárselo más adelante. |
| productPurchaseFailed | 1006 | La compra del producto falló. Esto envuelve un error subyacente de StoreKit — lee el error interno (o activa los logs detallados para verlo en la consola) para conocer el motivo real. El error interno suele ser uno de los códigos de StoreKit del 0 al 14 de la tabla anterior — los más habituales son paymentCancelled, paymentInvalid, paymentNotAllowed o invalidOfferPrice. Si no puedes identificar una causa concreta, prueba con un nuevo perfil de sandbox; si sigue fallando, contacta con el soporte de Apple. |
| refreshReceiptFailed | 1010 | Este error indica que no se recibió el recibo. Solo aplica a StoreKit 1. |
| receiveRestoredTransactionsFailed | 1011 | La restauración de la compra falló. |
Códigos de red personalizados
| Error | Código | Solución |
|---|---|---|
| notActivated | 2002 | El SDK de Adapty no está activado. Suele ocurrir cuando una splash screen o un hook de UI temprano llama a métodos de Adapty antes de que adapty.activate retorne. El síntoma es intermitente y puede no reproducirse en el simulador porque los tiempos en dispositivo real son diferentes. Usa await en activate antes de programar cualquier otra llamada al SDK. Consulta Orden de llamadas en el SDK de React Native para ver la secuencia completa. |
| badRequest | 2003 | Solicitud incorrecta. Asegúrate de haber completado todos los pasos necesarios para integrarte con el App Store. |
| serverError | 2004 | Error del servidor. Inténtalo de nuevo después de un tiempo. Si el problema persiste, contacta al equipo de soporte de Adapty. |
| networkFailed | 2005 | Este error indica problemas con la conexión de red en el dispositivo del usuario. Prueba desactivando la VPN o cambiando de red móvil a WiFi, o viceversa. |
| decodingFailed | 2006 | Este error indica que la decodificación de la respuesta falló. Revisa tu código y asegúrate de que los parámetros que envías son válidos. Por ejemplo, este error puede indicar que estás usando una clave de API no válida. |
| encodingFailed | 2009 | Este error indica que la codificación de la solicitud falló. |
| analyticsDisabled | 3000 | No podemos gestionar los eventos de analytics, ya que los has desactivado. |
| wrongParam | 3001 | Este error indica que alguno de tus parámetros no es correcto. Si estás usando el Paywall Builder de Adapty y no puedes mostrar un paywall debido a este error, activa Show on device en el Paywall Builder. Otra posible causa es que la versión del archivo de respaldo local no coincida con la versión del SDK. Descarga un nuevo archivo desde el dashboard. |
| activateOnceError | 3005 | No es posible llamar al método .activate más de una vez. |
| profileWasChanged | 3006 | El perfil de usuario cambió durante la operación. Esto ocurre cuando se llama a un método mientras adapty.identify aún está en curso — la llamada en vuelo llega a un perfil que está a punto de ser reemplazado y el SDK la rechaza. Usa siempre await en identify antes de cualquier llamada de acción del usuario. Consulta Orden de llamadas en el SDK de React Native. |
| unsupportedData | 3007 | Este error indica que el formato de datos no es compatible con el SDK. |
| persistingDataError | 3100 | Se produjo un error al guardar los datos. |
| fetchTimeoutError | 3101 | Este error indica que la operación de fetch superó el tiempo de espera. |
| operationInterrupted | 9000 | Esta operación fue interrumpida por el sistema. Reintenta la llamada. |
Otros problemas
Si todavía no has encontrado una solución, los siguientes pasos pueden ser:
- Actualiza el SDK a la última versión: Siempre recomendamos actualizar a las últimas versiones del SDK, ya que son más estables e incluyen correcciones de errores conocidos.
- Contacta con el equipo de soporte u obtén ayuda de otros desarrolladores en el foro de soporte.
- Contacta con el equipo de soporte a través de support@adapty.io o por el chat: Si no estás listo para actualizar el SDK o no ha resuelto el problema, contacta con nuestro equipo de soporte. Ten en cuenta que tu problema se resolverá más rápido si activas el registro detallado y compartes los logs con el equipo. También puedes adjuntar fragmentos de código relevantes.