Gestionar suscripciones de los usuarios

Para implementar la gestión de suscripciones en su aplicación, utilice la siguiente lógica:

1. Recupere la lista de suscripciones del usuario y muéstrela en la aplicación.
2. Implemente la gestión de suscripciones: abra la cuenta del suscriptor o gestione suscripciones específicas directamente desde su aplicación.

Si desea una implementación simplificada, consulte el ejemplo.

Recuperar suscripciones de los usuarios

Para recuperar todas las suscripciones activas del usuario actual, utilice el método XsollaSubscriptions.GetSubscriptions. El método devolverá las suscripciones con los estados active, non_renewing y freeze asociados a la cuenta del usuario actual.

También puede solicitar información detallada sobre cada suscripción utilizando el método XsollaSubscriptions.GetSubscriptionDetails.

Emplee los datos devueltos (el objeto SubscriptionItem) para mostrar la interfaz de gestión de suscripciones en su aplicación.

Campos clave para configurar los widgets de la interfaz de usuario:

• plan_name: nombre de la suscripción.
• status: estado actual de la suscripción (new, active, canceled, non_renewing, freeze).
• date_next_charge: fecha y hora del próximo cobro automático.
• charge: información sobre pagos recurrentes. El objeto contiene el precio (amount) y la moneda (currency).

Gestión de suscripciones

Abrir una cuenta de suscriptor

Xsolla ofrece una interfaz de usuario (la cuenta del suscriptor) prediseñada mediante la cual los usuarios pueden consultar la información sobre sus suscripciones y gestionarlas. Esta es la opción más sencilla y recomendada para implementar la gestión de suscripciones.

Características principales:

• la vista de detalles de la suscripción
• la gestión de suscripciones: cancelación inmediata, deshabilitación de la renovación automática o reactivación (dependiendo de la configuración del proyecto)
• el cambio del plan de suscripción
• la actualización del método de pago

Para mostrar la cuenta de suscriptor al usuario, llame al método XsollaSubscriptions.GetUserAccountUrl. Si la solicitud es aceptada, se transmitirá un objeto UserAccountLink que contiene un enlace a la interfaz de usuario de la cuenta a la función de devolución de llamada. Para abrir el enlace en un navegador externo o en un WebView integrado, utilice el método XsollaWebBrowser.Open.

Gestión de suscripciones específicas

Para abrir la interfaz de usuario de gestión de una suscripción específica desde su aplicación, use el método XsollaSubscriptions.GetSubscriptionManagementUrl. Si la solicitud es aceptada, se transmitirá a la función de devolución de llamada un objeto PaymentLink que contiene un enlace a la interfaz de gestión de suscripciones. Para abrir el enlace en un navegador externo o en un WebView integrado, utilice el método XsollaWebBrowser.Open.

Cancelación de suscripciones

Para implementar la cancelación de una suscripción desde la interfaz de usuario de su aplicación, utilice el método XsollaSubscriptions.CancelSubscription. Este método deshabilita la renovación automática y la suscripción pasará al estado non_renewing. Esto implica que no se efectuará ningún cargo automático en el próximo periodo de facturación; la suscripción seguirá activa hasta el final del periodo pagado.

Renovación de suscripción

Para implementar la navegación hacia la interfaz de usuario de renovación de la suscripción desde su aplicación, utilice el método XsollaSubscriptions.GetSubscriptionRenewalUrl. Si la solicitud es aceptada, se transmitirá a la función de devolución de llamada un objeto PaymentLink que contiene un enlace a la interfaz de renovación de suscripciones. Para abrir el enlace en un navegador externo o en un WebView integrado, utilice el método XsollaWebBrowser.Open.