Implementar paywalls web

Antes de empezar, asegúrate de haber configurado tu paywall web en el dashboard e instalado la versión 3.6.1 o posterior del SDK de Adapty.

Abrir paywalls web

Si trabajas con un paywall que desarrollaste tú mismo, necesitas gestionar los paywalls web mediante el método del SDK. El método .openWebPaywall:

Genera una URL única que permite a Adapty vincular un paywall específico mostrado a un usuario concreto con la página web a la que se le redirige.
Detecta cuando tus usuarios vuelven a la app y luego llama a .getProfile a intervalos cortos para determinar si los derechos de acceso del perfil se han actualizado.

De esta forma, si el pago se ha realizado con éxito y los derechos de acceso se han actualizado, la suscripción se activa en la app casi de inmediato.


try {
    await adapty.openWebPaywall(product);
} catch (error) {
    console.warn('Failed to open web paywall:', error);
}

Existen dos versiones del método openWebPaywall:

openWebPaywall(product) que genera URLs por paywall y también añade los datos del producto a las URLs.
openWebPaywall(paywall) que genera URLs por paywall sin añadir los datos del producto a las URLs. Úsalo cuando tus productos en el paywall de Adapty sean distintos a los del paywall web.

Gestionar errores

Error	Descripción	Acción recomendada
AdaptyError.paywallWithoutPurchaseUrl	El paywall no tiene configurada una URL de compra web	Comprueba si el paywall está correctamente configurado en el Adapty Dashboard
AdaptyError.productWithoutPurchaseUrl	El producto no tiene una URL de compra web	Verifica la configuración del producto en el Adapty Dashboard
AdaptyError.failedOpeningWebPaywallUrl	No se pudo abrir la URL en el navegador	Comprueba la configuración del dispositivo o proporciona un método de pago alternativo
AdaptyError.failedDecodingWebPaywallUrl	No se pudieron codificar correctamente los parámetros en la URL	Verifica que los parámetros de la URL sean válidos y estén correctamente formateados

Abrir paywalls web en un navegador integrado

La apertura de paywalls web en un navegador integrado está disponible a partir del SDK de Adapty v. 3.15.

Por defecto, los paywalls web se abren en el navegador externo.

Para ofrecer una experiencia de usuario fluida, puedes abrir los paywalls web en un navegador integrado. Esto muestra la página de compra web dentro de tu aplicación, permitiendo a los usuarios completar las transacciones sin cambiar de app.

Para activarlo, pasa WebPresentation.BrowserInApp como segundo argumento a openWebPaywall:


try {
    await adapty.openWebPaywall(
        product,
        WebPresentation.BrowserInApp, // default – WebPresentation.BrowserOutApp
    );
} catch (error) {
    console.warn('Failed to open web paywall:', error);
}