Obtener información sobre la suscripción

Puede obtener información sobre la actividad relacionada con las suscripciones de las siguientes maneras:

Establecer mediante métodos API

En el lado del cliente de su aplicación, implemente la obtención de información sobre las suscripciones del usuario usando una solicitud HTTP GET.

La API de Xsolla emplea autenticación HTTP de acceso. La solicitud debe contener un encabezado Authorization: Bearer <client_user_jwt>, en el cual <client_user_jwt> es un token único codificado según el estándar Base64. Para obtenerlo:

Nota
Para llamar a la API de Xsolla, puede utilizar los métodos del SDK prediseñados para motores y plataformas de juegos:

Especifique el ID del proyecto como parámetro de ruta projectId. Puede encontrar este parámetro en su Cuenta del editor junto al nombre del proyecto.

Especifique como parámetros de consulta:

  • limit - límite para el número de elementos que aparecen en la página (por defecto se muestran 15 elementos).
  • offset - número del elemento a partir del cual se genera la lista (el recuento empieza en el 0).
  • locale - idioma de la interfaz (inglés por defecto). Acepta valores de conformidad con la norma ISO 639-1.

Copy
Full screen
Small screen
curl -X 'GET' \
  'https://subscriptions.xsolla.com/api/user/v1/projects/{projectId}/subscriptions?locale=ru&limit=5&offset=5 ' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer client_user_jwt'
Copy
Full screen
Small screen
{
  "items": [
    {
      "id": 11111111,
      "plan_id": 11111,
      "plan_external_id": "TestChangePlanBase",
      "plan_name": "package_recurrent_name_66053",
      "plan_description": "package_recurrent_description_66053",
      "product_id": null,
      "product_external_id": null,
      "product_name": null,
      "product_description": null,
      "status": "active",
      "date_create": "2021-03-11T13:50:11+03:00",
      "date_next_charge": "2031-04-11T13:51:02+03:00",
      "date_last_charge": "2021-03-11T13:51:02+03:00",
      "charge": {
        "amount": "0.2500",
        "currency": "USD"
      },
      "period": {
        "value": 1,
        "unit": "day"
      }
    }
  ],
  "has_more": true
}

Configurar webhooks

La solución Subscriptions admite webhooks para los siguientes eventos:

Nota
Para cancelar una suscripción, debe cancelarse el último pago. Si un usuario ha renovado su suscripción manualmente y ha pagado varios periodos, debe cancelar todos los pagos.
  • Reembolso:
    • Reembolso (el pago se canceló en la Cuenta del editor)
    • Suscripción actualizada (el pago se canceló, pero la suscripción sigue activa. Esto puede pasar si el usuario pagó accidentalmente la suscripción dos veces y solo canceló el último pago)
    • Suscripción cancelada (el pago se canceló en la Cuenta del editor o se cancelaron todos los pagos para todos los períodos válidos)
Nota
Encontrará más información sobre los webhooks en nuestra documentación de la API.
Para establecer los webhooks:
  1. En Cuenta del editor, vaya a Project settings > Webhooks.
  2. Establezca el conmutador del bloque Webhooks en la posición On.

  1. Especifique la URL de su webhook. Haga clic en Save settings.

  1. Pruebe los webhooks en Cuenta de editor.
  2. Pruebe la compra de suscripción.
  3. Pruebe la renovación de suscripción.
  4. Pruebe la cancelación de suscripción.

Probar los webhooks en Cuenta del editor

  1. En Cuenta del editor > Project settings > Webhooks, vaya a la pestaña Subscriptions.
  1. Para probar los webhooks, especifique los valores de su proyecto (ID de usuario e ID de factura) que se deben enviar en una solicitud a la URL del webhook que proporcionó. En ausencia de valores reales, puede introducir valores arbitrarios. Rellene los siguientes campos del formulario:
Nota
En Cuenta del editor, solo puede probar los webhooks básicos Validación del usuario y Pago. Para probar otros tipos de webhooks, vaya a:
  1. Haga clic en Test.
  2. Compruebe que ha recibido un mensaje de prueba satisfactoria. Si la prueba se realiza correctamente, el servidor devolverá un código de estado HTTP 204. Si no se realiza correctamente, el servidor devolverá un código de estado HTTP 400 o 500 junto con una descripción del error.

Hacer prueba de compra de suscripción

Cuando se pruebe un pago, los webhooks Validación del usuario, Pago y Suscripción creada se enviarán a la URL que especificó en el paso Establecer webhooks. Para probar el proceso de pago, puede:
  • Utilizar el modo sandbox (para suscripciones con un período de prueba de 0 días)
  • Realizar un pago real y, luego, iniciar un reembolso a través de Cuenta del editor (para suscripciones con un periodo de prueba de más de 0 días)
Nota
Solo se pueden probar suscripciones con un periodo de prueba para pagos reales, ya que no se puede vincular una cuenta de facturación a una suscripción en modo sandbox.

Modo de aislador de proceso (sandbox)

  1. Obtenga un token para el modo sandbox. Transmita el valor 0 al parámetro Trial period (trial_days).
  2. Elija el grupo de métodos de pago Credit/debit cards.
  3. Introduzca los datos de la tarjeta bancaria de prueba. Introduzca cualquier valor en los campos restantes. También puede especificar datos incorrectos (número de tarjeta, fecha de caducidad o clave CVV) para generar un error.
Nota
En el modo Aislador de proceso (Sandbox) solo puede usar tarjetas bancarias de prueba. Los pagos con tarjeta bancaria en modo sandbox pueden realizarse en las siguientes monedas: USD, EUR, RUB, GBP, AED, ALL, AMD, ARS, AUD, AZN, BGN, BRL, BYN, CAD, CHF, CLP, CNY, COP, CZK, DKK, DZD, EGP, GEL, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KRW, KZT, MAD, MDL, MKD, MNT, MXN, MYR, NGN, PEN, PHP, PKR, PLN, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, UYU, UZS, VEF, VND y ZAR.
  1. Reciba los webhooks para Validación del usuario, Pago y Suscripción actualizada en la URL que especificó en el paso Establecer webhooks.

Pago real

Para probar el pago de una suscripción con periodo de prueba, tendrá que utilizar un pago real:
  1. Lleve a cabo una Prueba de webhooks en Cuenta del editor y active el módulo Subscriptions.
  2. Firme un Acuerdo de licencia.
Nota
La firma del Acuerdo de licencia activa la venta de suscripciones reales.
  1. Obtener un token para pagos reales.
Aviso
Elimine el parámetro “mode”:“sandbox” de la solicitud de token antes de empezar a recibir pagos reales.
  1. Abra la interfaz de pago con el siguiente enlace: https://secure.xsolla.com/paystation4/?token=ACCESS_TOKEN, en el cual ACCESS_TOKEN es el token obtenido en el paso anterior.
  2. Elija el grupo de métodos de pago Credit/debit cards.
  3. Introduzca los datos de una tarjeta bancaria válida.
Nota
Las tarjetas bancarias de prueba solo son adecuadas para el modo Aislador de proceso (Sandbox). Se recomienda usar tarjetas Visa y MasterCard para probar pagos reales.
  1. Reciba los webhooks Validación del usuario, Pago y Suscripción actualizada en la URL de webhook que proporcionó en el paso Establecer webhooks.
  2. Reembolse su pago. Para ello, vaya a Cuenta del editor > Support > Transaction search.
  3. Elija la transacción de prueba y haga clic en el botón del menú More (•••). Haga clic en Refund en el menú emergente (la transacción debe tener el estado Complete). Esto enviará los webhooks Suscripción cancelada y Reembolso.

Hacer prueba de renovación de suscripción

Aviso
Solo disponible para suscripciones sin periodo de prueba.
Para probar la renovación de suscripciones:
  1. Obtenga un token para el modo sandbox. Transmita el valor 0 al parámetro Trial period (trial_days).
  2. Pague su suscripción usando cualquier método de pago.
  3. Vuelva a abrir la interfaz de pago en modo sandbox.
  4. Vuelva a pagar para renovar su suscripción usando cualquier método de pago.
  5. Obtenga los webhooks Validación del usuario, Pago y Suscripción actualizada en la URL del webhook que especificó en el paso Establecer webhooks.

Hacer prueba de cancelación de suscripción

Para probar la cancelación de suscripciones, utilice:

Búsqueda por suscripción

  1. En Cuenta del editor vaya a Support > Subscribers.
  2. Busque la suscripción que desea cancelar.
  3. Abra el menú de estado de la suscripción y seleccione:
    1. Cancel and refund para recibir los webhooks Suscripción cancelada y Reembolso.
    2. Cancel without refund para recibir el webhook Suscripción cancelada.

Búsqueda por transacciones recientes

  1. En Cuenta del editor, vaya a Support > Transaction search.
  2. Busque las últimas transacciones que se hayan cancelado.
  3. Haga clic en el icono More (•••). Haga clic en Refund en el menú emergente para recibir los webhooks Suscripción cancelada y Reembolso.
Nota
Si la suscripción se ha pagado varias veces, deben cancelarse todos los pagos.

Utilizar llamadas API

Utilice la llamada API Actualizar suscripción para cambiar el estado de la suscripción a Canceled y recibir el webhook Suscripción cancelada.

Abrir la interfaz de pago en modo Aislador de proceso (Sandbox)

Para abrir la interfaz de pago en modo sandbox, obtenga un token con el modo sandbox activo. A continuación se indican las formas de obtener un enlace con el token necesario:

Mediante Cuenta del editor

  1. Pruebe los webhooks en Cuenta del editor. Especifique el valor 0 en el campo Trial period para probar una suscripción que no tenga un período de prueba. Cuando reciba un mensaje de confirmación relativo a que la prueba se ha realizado correctamente, aparecerá un enlace con el token necesario bajo el encabezado Sandbox URL.
  1. Pulse en el enlace Sandbox URL.

Mediante llamada API

  1. Transmita los parámetros "settings":{"mode":"sandbox"} al método Crear token. Transmita los parámetros "purchase": {"subscription":{"trial_days": 0}} para probar una suscripción que no tenga periodo de prueba.
  2. Utilice el siguiente enlace: https://sandbox-secure.xsolla.com/paystation4/?token=ACCESS_TOKEN, en el cual ACCESS_TOKEN es el token obtenido en el paso anterior.
Tu progreso
¡Gracias por tu mensaje!
Ú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!