English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

Solucionar problemas de integración con App Store

Este artículo cubre los problemas más comunes de integración con App Store. Cada sección describe los síntomas, la causa raíz y la solución.

”The provided field values are incorrect” al guardar las credenciales

Cuando guardas las credenciales de compra in-app, Adapty construye un token de autenticación a partir del In-app purchase Issuer ID, el In-app purchase Key ID y el archivo .p8, y lo valida con Apple. Este error significa que Apple rechazó el token. Comprueba los valores en este orden:

  1. Tipo de clave. La clave debe ser una clave de In-App Purchase de Users and Access → Integrations → In-App Purchase en App Store Connect. Una clave de la pestaña Team keys (la clave de la API de App Store Connect) tiene su propio Issuer ID y Key ID, pero Apple la rechaza aquí — esa clave pertenece al Paso 6 de la configuración.
  2. Misma cuenta y equipo. El Issuer ID, el Key ID y el archivo .p8 deben provenir del mismo equipo de App Store Connect que la app. Una clave generada en la cuenta de otro equipo — por ejemplo, la cuenta de una agencia — falla en la validación.
  3. El archivo .p8 en sí. Sube el archivo exactamente tal como lo descargaste de App Store Connect. Un archivo recreado a partir del contenido de la clave pegado manualmente suele fallar. App Store Connect solo permite descargar la clave una vez, así que si perdiste el archivo original, genera una nueva clave.
  4. Bundle ID. El Bundle ID debe coincidir exactamente con el bundle ID de tu app en App Store Connect — en formato DNS inverso sin espacios, por ejemplo, com.company.app.
  5. Caracteres ocultos. Vuelve a copiar cada ID directamente desde App Store Connect. Espacios en blanco o caracteres similares — por ejemplo, una l minúscula en lugar del dígito 1 — hacen que la validación falle.

Esta validación utiliza únicamente los tres campos de la clave de compra in-app y el Bundle ID. El App-Specific Shared Secret y la clave de la API de App Store Connect no participan en ella, por lo que volver a introducir cualquiera de estos dos no cambiará el resultado.

Los productos no aparecen

Dos síntomas distintos apuntan a la misma causa raíz:

  • La clave API de App Store Connect está configurada correctamente, pero Adapty no puede obtener los productos.
  • Los productos existen en App Store Connect pero no aparecen en Adapty, o aparecen menos de los esperados. El SDK reporta “Product Id not found” al intentar realizar una compra.

La causa más común es que los acuerdos de Apple estén sin firmar — el acuerdo de pago, los formularios fiscales o los formularios bancarios en estado pendiente o sin firmar. Cuando los acuerdos están pendientes, la API de App Store Connect devuelve silenciosamente un 403 en los endpoints relacionados con productos. No se muestra ningún error claro en Adapty; los productos simplemente se descartan sin aviso.

Ve a App Store Connect → Agreements, Tax, and Banking y firma todos los acuerdos pendientes. Luego vuelve a sincronizar en App settings → iOS SDK de Adapty.

Las notificaciones del servidor de App Store muestran “Delayed”

En App Store Connect, el estado de las App Store Server Notifications puede aparecer como Delayed. Esto significa que Apple tiene retraso en el envío de notificaciones de eventos de suscripción: renovaciones, cancelaciones y problemas de facturación se acumulan en cola y llegan tarde.

Las estadísticas de instalaciones no se ven afectadas. Adapty contabiliza las instalaciones desde el primer lanzamiento de la app, no a partir de notificaciones del servidor.

Si los datos de renovación o cancelación van por detrás, el estado Delayed es la causa más probable. El estado suele desaparecer automáticamente a medida que Apple procesa el backlog.

Una compra se realiza con éxito pero el cliente pierde el acceso

El cliente paga y tiene acceso brevemente, pero lo pierde la próxima vez que tu app actualiza el perfil desde Adapty. Apple procesó el pago, pero la transacción nunca llegó a Adapty; hasta que eso ocurra, el perfil no tiene ningún nivel de acceso y la venta no aparece en tus informes.

Normalmente la causa es una de estas:

  • Una credencial dejó de funcionar: Adapty no pudo validar la transacción con Apple. Sigue los pasos de Si las actualizaciones dejan de llegar y reemplaza la credencial que cubre la validación de compras.
  • El producto no está vinculado en Adapty: El ID de producto de la store que el cliente compró no está vinculado a ningún producto de Adapty, por lo que no existe ningún nivel de acceso que otorgar. Confirma que el producto existe con el App Store Product ID exacto y que tiene un nivel de acceso asignado.

El SDK de Adapty sigue reintentando la transacción, por lo que el acceso se restaura en cuanto Adapty puede registrarla.

Los precios en Adapty no coinciden con App Store

El campo price en la página de edición de productos de Adapty se comporta de forma distinta según cómo se haya añadido el producto.

Si creas un producto en Adapty y lo publicas en la store desde el dashboard, este precio se utiliza como precio inicial en la store.

Si añades un producto que ya existe en la store, este precio es un marcador de posición. Las analíticas, integraciones y SDK de Adapty utilizan los precios reales obtenidos de App Store, independientemente de este valor. Los cambios en los precios de App Store no se sincronizan para actualizar el marcador de posición, y por ahora no es posible editar ese marcador desde el dashboard.

La exportación de precios en CSV está vacía

Si tu exportación de precios en CSV solo devolvió las cabeceras de columna, significa que la clave API de App Store Connect no está completamente configurada. Consulta Paso 6 — Añadir clave API de App Store Connect.

No se pueden publicar nuevos productos en App Store

Adapty puede publicar nuevos productos en App Store Connect cuando los creas en el dashboard. La opción de publicar queda bloqueada si la integración con App Store no está completamente configurada. Se requieren dos ajustes: