Cómo permitir que un usuario cambie un plan de suscripción

Cómo funciona

• Al elegir un nuevo plan, se reembolsa al usuario el saldo del periodo no utilizado de la suscripción actual.
• El pago del nuevo plan de suscripción se realiza íntegramente con cargo al saldo del usuario. Si su saldo es insuficiente, se realiza un pago adicional mediante cualquiera de los métodos de pago permitidos en el proyecto.
• Al cambiar de plan, los fondos se cargan a cuenta inmediatamente después de confirmar el pago, aunque el proyecto esté configurado para cambiar de plan a partir del siguiente periodo de facturación.

• Si la moneda del nuevo plan es diferente de la moneda del plan actual, la compra del nuevo plan se hará con una conversión de moneda.

• el usuario ya tiene una suscripción activa con el plan al que está cambiando el plan actual
• la suscripción que el usuario desea modificar no se encuentra en el estado Active
• el plan de suscripción que el usuario desea cambiar es del tipo Lifetime plan: este tipo de suscripción solo puede cancelarse dentro del periodo de reembolso especificado

Cómo conseguirlo

1. Abra su proyecto en Cuenta del editor.
2. Haga clic en Subscriptions en la barra lateral y vaya a la sección Settings.
3. En la sección Changing plan, establezca la opción Posibilidad de elegir un plan diferente estableciendo el conmutador en On.
4. Los cambios de plan se permiten a partir del siguiente periodo predeterminado. Para permitir el cambio de plan en el periodo actual, seleccione Ahora. Si selecciona esta opción, el plan cambia inmediatamente después de confirmarse el pago.
5. Para permitir cambios de plan más de una vez al día, establezca el conmutador “Ability to choose a different plan on the same day” en On.
6. Al abrir la interfaz de pago, utilice:
   • llamada API Crear token del lado del cliente
   • llamada API del lado del cliente para obtener un enlace para abrir una interfaz de pago si utiliza Xsolla Login en su proyecto

Abrir la interfaz de pago mediante la llamada API Crear token del lado del servidor

1. Obtenga un token para abrir la interfaz de pago transmitiendo lo siguiente al método:
   • valor change_plan en el parámetro purchase.subscription.operation.
   • ID del nuevo plan en el parámetro purchase.subscription.plan_id.
   • ID del producto basado en suscripción en el parámetro purchase.subscription.product_id si utiliza productos basados en suscripción. Para obtenerlo, contacte con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com.
2. Abra la interfaz de pago de una de las siguientes maneras:
   • script Pay Station Embed
   • Iframe
   • Nueva ventana

Abrir la interfaz de pago en la página de gestión de suscripciones mediante la llamada API del lado del cliente

Si Xsolla Login está configurado en su proyecto, puede utilizar la llamada API del lado del cliente para obtener un enlace para abrir la interfaz de pago. El enlace devuelto en la respuesta le permite abrir la interfaz de pago de la página de gestión de suscripciones, en la cual los usuarios pueden seleccionar una suscripción activa y modificarla.

Para ello, en el lado del cliente de su aplicación, implemente la recepción de un enlace a la interfaz de pago utilizando una solicitud HTTP POST: https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/manage. La solicitud debe contener un encabezado Authorization: Bearer <client_user_jwt>, en el cual <client_user_jwt> es el JSON Web Token (JWT) del usuario, un token único codificado en Base64 según el estándar Base64. Para obtener el token:

• Utilice las llamadas API Register new user y Auth by username y de contraseña si su aplicación utiliza la autorización de inicio de sesión y contraseña.
• Utilice la llamada API Auth via social network si su aplicación utiliza autorización mediante redes sociales.

Transmita parámetros adicionales para la personalización si es necesario.

Parámetros del cuerpo de la solicitud:

curl -X 'POST' \
'https://subscriptions.xsolla.com/api/user/v1/projects/{project_id}/subscriptions/manage?country=RU  ' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer client_user_jwt'
{
  "settings": {
    "ui": {
      "size": "large",
      "theme": "string",
      "version": "desktop",
      "desktop": {
        "header": {
          "is_visible": true,
          "visible_logo": true,
          "visible_name": true,
          "type": "compact",
          "close_button": true
        }
      },
      "mobile": {
        "mode": "saved_accounts",
        "footer": {
          "is_visible": true
        },
        "header": {
          "close_button": true
        }
      },
      "license_url": "string",
      "mode": "user_account",
      "user_account": {
        "history": {
          "enable": true,
          "order": 1
        },
        "payment_accounts": {
          "enable": true,
          "order": 1
        },
        "info": {
          "enable": true,
          "order": 1
        },
        "subscriptions": {
          "enable": true,
          "order": 1
        }
      }
    },
    "currency": "str",
    "locale": "st",
    "external_id": "string",
    "payment_method": 1,
    "return_url": "string",
    "redirect_policy": {
      "redirect_conditions": "none",
      "delay": 0,
      "status_for_manual_redirection": "none",
      "redirect_button_caption": "string"
    }
  }
}

Ejemplo de respuesta:

{
  "link_to_ps": "https://secure.xsolla.com/paystation2/?access_token=<access_token>"
}