Cuenta del suscriptor

Cómo funciona

La cuenta de suscriptor es un servicio que permite a los usuarios ver y gestionar sus suscripciones configuradas en su proyecto de Xsolla.

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

• pulsando en el enlace de las notificaciones por correo electrónico relacionadas con la suscripción de Xsolla
• desde la página de pago dentro del juego

• usando las llamadas API del lado del servidor
• usando las llamadas API del lado del cliente

Obtener un enlace de cuenta del suscriptor mediante API

Llamada del lado del servidor

La llamada le permite implementar la generación de un enlace a la cuenta del suscriptor desde el servidor de sus aplicaciones mediante una solicitud HTTP POST.

Dirección URL:

https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account

Autorización:

La API de Xsolla usa una autenticación básica de acceso. Todas las solicitudes a la API deben contener el encabezado Authorization: Basic <your_authorization_basic_key>, en el cual <your_authorization_basic_key> es el par merchant_id:api_key codificado según el estándar Base64. Vaya a Cuenta del editor para encontrar estos parámetros:

• merchant_id se muestra:
  • En la sección Company settings > Company .
  • En la URL de la barra de direcciones del navegador en cualquier página de Cuenta del editor. La URL tiene el siguiente formato: https://publisher.xsolla.com/<merchant_id>.
• api_key se muestra en Cuenta del editor solamente cuando se crea, y debe almacenarse en su lado. Puede crear una nueva clave en la siguiente sección:
  • Company settings > API keys
  • Project settings > API keys

Parámetros:

Como parámetro de ruta, especifique project_id: el ID del proyecto, que se especifica en Cuenta del editor junto al nombre de su proyecto o en la barra de direcciones del navegador en cualquier página del proyecto. La URL tiene el siguiente formato: https://publisher.xsolla.com/<merchantId>/projects/<projectId>.

Parámetros del cuerpo:

 1curl -v https://subscriptions.xsolla.com​/api/v1/projects/{projectId}/subscriptions/user_account \
 2-X POST \
 3-u your_merchant_id:merchant_api_key \
 4-H 'Content-Type:application/json' \
 5-H 'Accept: application/json' \
 6-d '
 7{
 8  "user_v1": "user123",
 9  "locale": "en"
10}'

Ejemplo de respuesta:

1{
2  "redirect_url": "https://subscriptions-user-account.xsolla.com/?token=<access_token>&projectId=<project_id>&merchantId=<merchant_id>&locale=<locale>"
3}

Llamada del lado del cliente

La llamada le permite generar un enlace a la cuenta del suscriptor desde el lado del cliente de sus aplicaciones mediante una solicitud HTTP GET si Xsolla Login está configurado para su proyecto.

Dirección URL:

https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account

Autorización:

La solicitud debe contener un encabezado Authorization: Bearer <client_user_jwt>, en el cual <client_user_jwt> es el oken web JSON (JWT) del usuario, un token único codificado en Base64 según el estándar Base64. Para obtener el token, haga lo siguiente:

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

Parámetros:

Como parámetro de ruta, especifique project_id: el ID del proyecto, que se especifica en Cuenta del editor junto al nombre de su proyecto o en la barra de direcciones del navegador en cualquier página del proyecto. La URL tiene el siguiente formato: https://publisher.xsolla.com/{merchant_id}/projects/{project_id}.

Como parámetro de consulta, especifique locale: idioma de la interfaz en dos letras minúsculas conforme a la norma ISO 639-1. Si no se transmite este parámetro, el idioma se determinará mediante la dirección IP del usuario. Si la configuración regional transmitida no figura en la lista de Xsolla, se utilizará el inglés por defecto.

Ejemplo de solicitud:

1curl -v https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account \
2-X GET \
3-u your_merchant_id:merchant_api_key \
4-H 'Content-Type:application/json' \
5-H 'Accept: application/json' \

Ejemplo de respuesta:

1{
2  "redirect_url": "https://subscriptions-user-account.xsolla.com/?token=<access_token>&projectId=<project_id>&merchantId=<merchant_id>&locale=<locale>"
3}