Comience
Flujo de integración
Para integrar Subscriptions:
- Cree un proyecto para su juego.
- Establezca planes de suscripción.
- Establezca la autorización.
- Cree la interfaz de usuario del catálogo.
- Establezca la apertura de la interfaz de pago.
- Implemente la obtención de información de suscripción.
- Firme el acuerdo de licencia.
Cómo funciona
Comprar suscripción
Renovación automática de suscripción recurrente
Flujo del usuario
Glosario
Plan de suscripción
Producto de pago por suscripción
Un servicio o conjunto de servicios suministrados a un usuario cuando adquiere la suscripción. La llamada a la API Crear producto se utiliza para crear un producto. La creación de un producto es necesaria si establece la venta de suscripciones independientes para diferentes servicios o si desea ofrecer a un usuario la opción de obtener varias suscripciones al mismo tiempo. Un producto de pago por suscripción puede ser el acceso al canal de un streamer, a un juego o a un/a objeto/capacidad única. Puedes leer más sobre cómo establecer y utilizar los productos de pago por suscripción en estas instrucciones.
Suscripción
Una combinación del producto y el plan elegido. Se crea una suscripción cuando un usuario selecciona un plan de suscripción y obtiene acceso a un servicio. El número de suscripciones que un usuario puede obtener al mismo tiempo depende del número de productos del proyecto. Las condiciones de la suscripción (periodo de facturación, coste y otras condiciones) corresponden a las condiciones del plan seleccionado. Las condiciones de la suscripción existente no se modifican si las condiciones del plan se cambiaron después de crear la suscripción.
EJEMPLO 1
Producto: acceso al juego
- Plan de suscripción
Silver : 10 $ al mes - Plan de suscripción
Gold : 100 $ al año
Un usuario puede seleccionar una de las siguientes suscripciones:
- Suscripción 1: acceso al juego1 con el plan de 10 $/mes
- Suscripción 2: acceso al juego2 con el plan de 100 $/año
EJEMPLO 2
Producto 1: acceso al juego1
Producto 2: acceso al juego2
- Plan de suscripción: 10 $ al mes
Un usuario puede obtener dos suscripciones simultáneamente:
- Suscripción 1: acceso al juego1 con el plan de 10 $/mes
- Suscripción 2: acceso al juego2 con el plan de 10 $/mes
Grupo de planes
Conjunto de planes que tienen el mismo valor del parámetro group_id
.
Para crear o modificar un grupo, transmita el parámetro group_id
a las llamadas API:
Crear un grupo de planes es necesario si desea:
crear un producto de pago por suscripción
limitar el número de planes que puede elegir para suscribirse a un producto
dejar que el usuario cambie a otro plan del mismo grupo
Puede obtener más información sobre cómo establecer y usar los grupos en estas instrucciones.
Período de prueba
- Cuando se adquiere una suscripción con un periodo de prueba, se crea una cuenta de facturación y se realiza un pago de autorización. Se cobra un pequeño importe a la cuenta del usuario y, después, se reembolsa. Cuando se carga el pago, no se envía un webhook de pago a la URL del webhook.
- Tras finalizar el periodo de prueba, se cobra el coste total del plan de suscripción y se envían los webhooks Payment y Updated subscription a la URL del webhook. Si el pago de la suscripción no se realiza correctamente, se envía el webhook Canceled Subscription. El periodo de prueba no se incluye en el periodo de validez del plan y su duración se calcula por separado.
- Se puede añadir un periodo de prueba como bonificación para una promoción.
Período de gracia
- Un periodo de gracia sólo está disponible para las suscripciones con plan periódico y pago único. Las suscripciones con tipo de renovación de pago automático se cobran automáticamente.
- Xsolla notifica al usuario la necesidad de realizar el pago en el momento en que se activa el periodo de gracia y cada día posterior al final del periodo de gracia.
- Si el usuario paga una suscripción durante el periodo de gracia, el pago se realiza por el periodo de pago completo.
- El número de días que el usuario tiene acceso al servicio del socio sin haber abonado el pago se resta del número total de días de un periodo de suscripción.
- Si el valor del campo Periodo de gracia de la configuración del plan es
0
, el plan no tiene periodo de gracia.
Periodo de reintento
- El periodo de reintentos solo está disponible para las suscripciones plan periódico y pago automático.
- Los intentos de cargo se realizan a una cuenta de pago guardada una vez al día.
- El sistema intentará realizar el cargo hasta que la suscripción se renueve, sea cancelada por un usuario o se cancele tras superar el número de reintentos de facturación.
- Si un usuario renueva la suscripción antes de que finalice el periodo de reintentos, el número de días durante los cuales el usuario tiene acceso al servicio del socio sin haber abonado el pago se sustrae del número total de días de un periodo de suscripción.
- Si el valor del campo Número de reintentos de facturación de la configuración del plan es
0
, el plan no tiene periodo de reintentos.
Pago automático
Pago único
Estados de suscripción
Una suscripción puede tener uno de los siguientes estados:
- Active. Estado primario. La suscripción se crea y activa tras el primer pago realizado correctamente. Los cobros posteriores solo son posibles para las suscripciones activas.
- Canceled. La suscripción se ha cancelado con efecto inmediato por uno de los siguientes motivos:
- Cambio de estado mediante un método API o desde la Cuenta del editor de Xsolla.
- Cancelada por el usuario.
- Expirada, si se estableció una fecha de expiración en los parámetros.
- Se superó el número máximo de intentos de cobro. Este número es tres por defecto; contacte con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com para cambiarlo.
- Usuario no encontrado en el juego.
- Cuenta de usuario eliminada.
- Non renewing. Renovación de suscripción cancelada. La suscripción durará hasta que finalice el ciclo de facturación actual antes de que el estado cambie a Cancelado. Una renovación puede cancelarse por uno de los siguientes motivos:
- Cambio de estado mediante un método API o desde la Cuenta del editor.
- Cancelada por el usuario a través de un enlace de correo electrónico.
- Cuenta de usuario eliminada.
¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.