Comience

Flujo de integración

Para integrar Subscriptions:

  1. Cree un proyecto para su juego.
  2. Establezca planes de suscripción.
  3. Establezca la autorización.
  4. Cree la interfaz de usuario del catálogo.
  5. Establezca la apertura de la interfaz de pago.
  6. Implemente la obtención de información de suscripción.
  7. 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
Condiciones de facturación (importe de facturación, moneda y frecuencia) con arreglo a las cuales un usuario tiene acceso al servicio. Establecer un plan es un paso de integración obligatorio.
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
Nota
Si el producto de pago por suscripción no está establecido, el usuario sólo puede obtener una suscripción cada vez. Para obtener varias suscripciones simultáneamente, debe establecer productos.
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
Periodo durante el cual el usuario puede probar la suscripción sin pagar por ella. Características:
  • 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 pago aplazado. Durante este periodo, los usuarios que no hayan pagado su suscripción a tiempo pueden seguir utilizando los servicios. Características:
  • 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.
Puede obtener más información sobre cómo establecer un periodo de pago en estas instrucciones.
Periodo de reintento
Periodo en el que se intenta cargar un importe a la cuenta de pago guardada. En este periodo los usuarios pueden seguir usando los servicios de suscripción. Se activa tras un cargo a cuenta fallido. Características:
  • 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.
Puede obtener más información sobre cómo establecer un periodo de reintentos en estas instrucciones.
Pago automático
Un tipo de renovación de suscripción por el cual se hace un cargo automáticamente en la cuenta de facturación guardada. No se requiere ninguna acción por parte del usuario. Si no se ha guardado la cuenta de facturación, una suscripción con un tipo de pago automático cambia al estado de Non renewing.
Pago único
Tipo de renovación de suscripción cuando los cargos los realiza el usuario con el enlace de pago recibido por correo electrónico. Se utiliza si el usuario selecciona un método de pago que no admite pagos automáticos.

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.

Aviso
No se puede crear una suscripción manualmente mediante la API; esto solo se puede hacer automáticamente al realizar una compra.
  • 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.
Nota
Cuando se cancela una suscripción, se puede reembolsar el último pago. Esta opción está disponible tanto para el socio como para el usuario.
  • 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.
¿Te ha resultado útil este artículo?
¡Gracias!
¿Hay algo en lo que podamos mejorar? Mensaje
Lo sentimos
Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.
Última actualización: 31 de Julio de 2024

¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.

Informar de un problema
Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
Déjanos tu correo electrónico para que te podamos responder
¡Gracias por tu mensaje!