Almacenamiento personalizado de datos de usuarios

Si usa un almacenamiento de datos de usuario personalizado, Xsolla Login interviene como intermediario y todos los datos de identificación del usuario se almacenan en su lado. Xsolla Login transmite los datos de autenticación en el token que se incluye en el encabezado de los webhooks y en sus cuerpos.

Las direcciones de correo electrónico de los usuarios, los datos de las redes sociales y los atributos de los usuarios se almacenan en el lado de Xsolla. Las contraseñas no se almacenan en el lado de Xsolla.

Si utiliza el almacenamiento personalizado, tendrá acceso a:

registro de usuario
autenticación mediante nombre de usuario y contraseña
autenticación sin contraseña mediante número de teléfono
autenticación sin contraseña mediante correo electrónico
autenticación mediante redes sociales
restablecimiento de contraseña de usuario

Si está probando la integración localmente, las solicitudes POST realizadas desde Xsolla no llegan a las URL como http://localhost:3000/my-webhook-endpoint. Ngrok le permite crear un túnel de acceso externo, permitiéndole recibir solicitudes de Xsolla localmente. Puede obtener más información en la documentación de ngrok.

Flujo de interacción

El escenario de interacción depende del protocolo de autenticación que elija: JWT u OAuth 2.0.

Puede utilizar el widget de inicio de sesión o su aplicación, que usa las llamadas de Login API como un cliente. El flujo de interacción entre el cliente y el servidor de Xsolla Login es el siguiente:

El cliente envía solicitudes al servidor de Xsolla Login. El formato de las solicitudes se describe en Authentication methods.
El servidor de Xsolla Login envía webhooks a su servidor. El encabezado incluye un JWT de servidor con el parámetro “request_type”: “gateway_token”. Para configurar la validación de tókenes, siga las instrucciones. Una parte de los datos de identificación del usuario se transmite en el cuerpo del webhook.
Para confirmar la recepción del webhook, su servidor debe devolver:
- Código HTTP 200, 201 o 204 en caso de respuesta correcta.
- Código HTTP 400 con la descripción del problema si no se encuentra el usuario especificado o se transmitió una firma no válida. Su controlador de webhook también puede devolver un código HTTP 5xx si se producen problemas temporales en su servidor.

El servidor de Xsolla Login procesa una respuesta de su servidor y devuelve el token de autorización al cliente.
El cliente envía la solicitud Generar JWT POST al servidor de Xsolla Login. El cuerpo de la solicitud debe incluir los siguientes parámetros obligatorios:
- grant_type: tipo de concesión JWT, transmitir el valor authorization_code.
- client_id: ID de cliente OAuth 2.0.
- client_secret: ID secreto de cliente OAuth 2.0. Obligatorio para el tipo de autenticación confidencial.
- code: código de autorización.
El servidor de Xsolla Login devuelve un par de JWT al cliente: un token de acceso y un token de actualización.
El cliente procesa la respuesta.
Cuando el token de acceso caduca, el cliente envía la solicitud Generar JWT POST al servidor de Xsolla Login. El cuerpo de la solicitud debe incluir los siguientes parámetros obligatorios:
- grant_type: tipo de concesión JWT, transmitir el valor refresh_token.
- client_id: ID de cliente OAuth 2.0.
- refresh_token: el token de actualización recibido en la respuesta a la solicitud de autorización del usuario.

Puede añadir información del usuario al JWT cuando identifique un usuario o actualice un token, devuelva un objeto JSON con cualquier conjunto de parámetros en el cuerpo de la respuesta. Este objeto se guardará en el campo partner_data del JWT.

La longitud máxima del texto en formato JSON con datos adicionales del usuario es de 1000 caracteres.

Los siguientes datos pueden incorporarse a las propiedades del perfil de usuario:

alias
fecha de nacimiento
nombre
apellidos
ID de usuario en su servidor

También puede actualizar los atributos de usuario transmitiendo una matriz de objetos con atributos de usuario. Abajo se describe la estructura de estos objetos.

Estructura de un objeto con atributos de usuario:

Parámetro	Tipo	Descripción
attr_type	string	Definición del nivel de acceso del usuario a los atributos de servicio: `client` - Un atributo editable por el usuario. Los valores para este tipo de atributo son introducidos por el usuario o especificados conforme a la lógica del juego en el lado del cliente. Por ejemplo, el nombre y las estadísticas del personaje, el nivel de dificultad del juego, etc. (por defecto) `server` - Un atributo de solo lectura. Los valores de este tipo de atributo se introducen y editan en el lado del servidor de su aplicación. Te recomendamos que los utilices para configurar las estadísticas de los personajes del juego o los parámetros de usuario que no deban cambiar regularmente. Por ejemplo, la posibilidad de obtener una bonificación, parámetros clave del personaje del juego, categorías de usuario, etc.
key	string	El nombre del atributo que se utiliza para identificar el atributo del usuario. Debe ser único para cada usuario. Longitud máxima: 256 símbolos. Se pueden utilizar números, caracteres latinos, guiones y guiones bajos.
permission	string o null	El tipo de acceso a los atributos del usuario afecta a la lista de atributos devuelta por los métodos: Get user’s attributes from client Get users by attribute from server Get user’s attributes from server Get user’s read-only attributes from server Valores posibles: `public` y `private` (por defecto).
read_only	string	Si el atributo está protegido, o no, de las modificaciones. Por defecto, se permite `false` y cambiar los valores del atributo.
value	string	El valor del atributo de usuario. Longitud máxima: 256 símbolos.

Registro de usuarios

El escenario de interacción depende del protocolo de autenticación que elija: JWT u OAuth 2.0.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'labelBoxBkgColor': 'transparent', 'labelBoxBorderColor': '#8ADCEC', 'altSectionBkgColor': 'transparent' }, 'sequence': {'noteMargin': 50}}}%%
sequenceDiagram
  participant U as Usuario
  participant YC as Su cliente
  participant XL as Servidor de Xsolla Login
  participant YS as Su servidor
  U->>YC: Introduce los datos de registro
  YC->>XL: Envía una solicitud de registro de usuario
  XL->>YS: Envía un webhook
  alt Registro realizado correctamente
    YS-->>XL: Devuelve un código HTTP 2xx y un cuerpo opcional
    opt El cuerpo de la respuesta contiene los datos del usuario
      activate XL
      note right of XL: Guarda los atributos y añade información a los datos del usuario
      deactivate XL
    end
    XL-->>YC: Devuelve el JWT del usuario
    YC-->>U: Notifica al usuario
  else Registro fallido
    YS-->>XL: Devuelve un error
    XL-->>YC: Devuelve un error de registro
    YC-->>U: Muestra un mensaje de error
  end

El cliente envía la solicitud de Register new user POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: ID del proyecto de Login en Cuenta del editor.
- Parámetros del cuerpo:
  - username: nombre de usuario. Longitud permitida: de 3 a 255 caracteres.
  - password: contraseña de usuario. Longitud permitida: de 6 a 100 caracteres.
  - email: dirección de correo electrónico. del usuario. Longitud permitida: de 1 a 255 caracteres.
El servidor de Xsolla Login envía un webhook a la URL de nuevo usuario. La respuesta debe tener el formato descrito en este flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

El cliente envía la solicitud de Register new user POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: ID del proyecto de inicio de sesión en la cuenta para juegos en móviles.
- Parámetros del cuerpo:
  - username: nombre de usuario. Longitud permitida: de 3 a 255 caracteres.
  - password: contraseña de usuario. Longitud permitida: de 6 a 100 caracteres.
  - email: dirección de correo electrónico. del usuario. Longitud permitida: de 1 a 255 caracteres.
El servidor de Xsolla Login envía un webhook a la URL de nuevo usuario. La respuesta debe tener el formato descrito en este flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

El cliente envía la solicitud Register new user POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId — ID del proyecto de Login en tu cuenta.
- Parámetros del cuerpo:
  - username — nombre de usuario. Longitud permitida: de 3 a 255 caracteres.
  - password — contraseña de usuario. Longitud permitida: de 6 a 100 caracteres.
  - email — dirección de correo electrónico del usuario. Longitud permitida: de 1 a 255 caracteres.
El servidor de Xsolla Login envía un webhook a la New user URL. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, puedes especificar una lista de atributos de usuario y/o cualquier objeto JSON necesario. El objeto JSON que proporciones en la respuesta se registra en el campo partner_data del JWT del usuario.

Para asignar campos JSON a propiedades de perfil de usuario en Xsolla y configurar la vinculación de cuentas por ID de usuario en su servidor, siga las instrucciones.

Ejemplo de webhook:

Copy

Full screen

Small screen

http

1POST https://your.hostname/your_registration_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email":"[email protected]",
7  "password":"123456",
8  "username":"[email protected]"
9}

1curl --request POST \
2  --url 'https://your.hostname/your_registration_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"email":"[email protected]","password":"123456","username":"[email protected]"}'

Ejemplo de respuesta a un webhook con atributos de usuario:

Copy

Full screen

Small screen

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

Ejemplo de respuesta a un webhook con un objeto JSON:

Copy

Full screen

Small screen

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "[email protected]"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

Los datos del usuario se escriben en la base de datos de Xsolla, mientras que el email se marca como sin confirmar. El usuario recibirá un correo electrónico de confirmación de la cuenta.
Si ha integrado el widget de Login, se redirigirá al usuario a la página con el siguiente mensaje: Por favor, confirma tu cuenta siguiendo las instrucciones que enviamos a {email}.
Si el registro del usuario no se realiza correctamente, puede proporcionar un mensaje de error que se mostrará en el widget de autenticación. Para ello, en la respuesta a la solicitud de creación del usuario, transmita un objeto de error con los siguientes detalles:
- en el parámetro de code, especifique 011-002.
- En el parámetro de description, facilite el texto del mensaje de error.

Ejemplo de objeto con un mensaje de error:

Copy

Full screen

Small screen

1{
2  "error": {
3    "code": "011-002",
4    "description": "<string>"
5  }
6}

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'labelBoxBkgColor': 'transparent', 'labelBoxBorderColor': '#8ADCEC', 'altSectionBkgColor': 'transparent' }, 'sequence': {'noteMargin': 50}}}%%
sequenceDiagram
  participant U as Usuario
  participant YC as Su cliente
  participant XL as Servidor de Xsolla Login
  participant YS as Su servidor
  U->>YC: Introduce los datos de registro
  YC->>XL: Envía una solicitud de registro de usuario
  XL->>YS: Envía un webhook
  alt Registro realizado correctamente
    YS-->>XL: Devuelve un código HTTP 2xx y un cuerpo opcional
    opt El cuerpo de la respuesta contiene los datos del usuario
      activate XL
      note right of XL: Guarda los atributos y añade información a los datos del usuario
      deactivate XL
    end
    XL-->>YC: Devuelve un código de autorización
    YC->>XL: Envía una solicitud para generar el JWT del usuario
    XL-->>YC: Devuelve el JWT del usuario y el token de actualización
    YC-->>U: Notifica al usuario
  else Registro fallido
    YS-->>XL: Devuelve un error
    XL-->>YC: Devuelve un error de registro
    YC-->>U: Muestra un mensaje de error
  end

El cliente envía la solicitud Register new user POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- Parámetros de consulta:
  - response_type: tipo de concesión JWT, transmitir el valor code.
  - client_id: ID de cliente OAuth 2.0.
  - state: valor que se utiliza para la autenticación adicional del usuario. Obligatorio para evitar los ataques de CSRF. Se devuelve en la respuesta. Longitud permitida: de 1 a 8 caracteres.
- Parámetros del cuerpo:
  - username: nombre de usuario. Longitud permitida: de 3 a 255 caracteres.
  - password: contraseña de usuario. Longitud permitida: de 6 a 100 caracteres.
  - email: dirección de correo electrónico del usuario. Longitud permitida: de 1 a 255 caracteres.
El servidor de Xsolla Login envía un webhook a la URL de nuevo usuario. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

Para asignar campos JSON a propiedades de perfil de usuario en Xsolla y configurar la vinculación de cuentas por ID de usuario en su servidor, siga las instrucciones.

Ejemplo de webhook:

Copy

Full screen

Small screen

http

1POST https://your.hostname/your_registration_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email":"[email protected]",
7  "password":"123456",
8  "username":"[email protected]"
9}

1curl --request POST \
2  --url 'https://your.hostname/your_registration_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"email":"[email protected]","password":"123456","username":"[email protected]"}'

Ejemplo de respuesta a un webhook con atributos de usuario:

Copy

Full screen

Small screen

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

Ejemplo de respuesta a un webhook con un objeto JSON:

Copy

Full screen

Small screen

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "[email protected]"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

Los datos del usuario se escriben en la base de datos de Xsolla, mientras que el email se marca como sin confirmar. El usuario recibirá un correo electrónico de confirmación de la cuenta.
Si ha integrado el widget de Login, se redirigirá al usuario a la página con el siguiente mensaje: Por favor, confirma tu cuenta siguiendo las instrucciones que enviamos a {email}.
Si el registro del usuario no se realiza correctamente, puede proporcionar un mensaje de error que se mostrará en el widget de autenticación. Para ello, en la respuesta a la solicitud de creación del usuario, transmita un objeto de error con los siguientes detalles:
- en el parámetro de code, especifique 011-002.
- En el parámetro de description, facilite el texto del mensaje de error.

Ejemplo de objeto con un mensaje de error:

Copy

Full screen

Small screen

1{
2  "error": {
3    "code": "011-002",
4    "description": "<string>"
5  }
6}

Autenticación mediante nombre de usuario y contraseña

El escenario de interacción depende del protocolo de autenticación que elija: JWT u OAuth 2.0.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'labelBoxBkgColor': 'transparent', 'labelBoxBorderColor': '#8ADCEC', 'altSectionBkgColor': 'transparent' }, 'sequence': {'noteMargin': 50}}}%%
sequenceDiagram
  participant U as Usuario
  participant YC as Su cliente
  participant XL as Servidor de Xsolla Login
  participant YS as Su servidor
  U->>YC: Introduce el nombre de usuario y la contraseña
  YC->>XL: Envía una solicitud de autenticación de usuario
  XL->>YS: Envía un webhook
  alt Autenticación realizada correctamente
    YS-->>XL: Devuelve un código HTTP 2xx y un cuerpo opcional
    opt El cuerpo de la respuesta contiene los datos del usuario
      activate XL
      note right of XL: Guarda los atributos y añade información a los datos del usuario
      deactivate XL
    end
    XL-->>YC: Devuelve el JWT del usuario
    YC-->>U: Completa la autenticación
  else Autenticación fallida
    YS-->>XL: Devuelve un error
    XL-->>YC: Devuelve un error de autenticación
    YC-->>U: Muestra un mensaje de error
  end

El cliente envía la solicitud Auth by username and password POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: ID del proyecto de Login en Cuenta del editor.
- Parámetros del cuerpo:
  - username: nombre de usuario. Longitud permitida: de 3 a 255 caracteres.
  - password: contraseña de usuario. Longitud permitida: de 6 a 100 caracteres.
El servidor de Xsolla Login envía un webhook a la URL de verificación de usuario. La respuesta debe tener el formato descrito en este flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

El cliente envía la solicitud Auth by username and password POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: ID del proyecto de inicio de sesión en la cuenta para juegos en móviles.
- Parámetros del cuerpo:
  - username: nombre de usuario. Longitud permitida: de 3 a 255 caracteres.
  - password: contraseña de usuario. Longitud permitida: de 6 a 100 caracteres.
El servidor de Xsolla Login envía un webhook a la URL de verificación de usuario. La respuesta debe tener el formato descrito en este flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

El cliente envía la solicitud Auth by username and password POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId — ID del proyecto de Login en tu cuenta.
- Parámetros del cuerpo:
  - username — nombre de usuario. Longitud permitida: de 3 a 255 caracteres.
  - password — contraseña de usuario. Longitud permitida: de 6 a 100 caracteres.
El servidor de Xsolla Login envía un webhook a la User verification URL. La respuesta debe tener el formato descrito en este flujo de interacción. En la respuesta, puedes especificar una lista de atributos de usuario y/o cualquier objeto JSON necesario. El objeto JSON que proporciones en la respuesta se registra en el campo partner_data del JWT del usuario.

Para asignar campos JSON a propiedades de perfil de usuario en Xsolla y configurar la vinculación de cuentas por ID de usuario en su servidor, siga las instrucciones.

Ejemplo de webhook de URL de verificación del usuario:

Copy

Full screen

Small screen

http

1POST https://your.hostname/your_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email":"[email protected]",
7  "password":"123456",
8  "username":"[email protected]"
9}

1curl --request POST \
2  --url 'https://your.hostname/your_authentication_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"email":"[email protected]","password":"123456","username":"[email protected]"}'

Ejemplo de respuesta a un webhook con atributos de usuario:

Copy

Full screen

Small screen

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

Ejemplo de respuesta a un webhook con un objeto JSON:

Copy

Full screen

Small screen

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "[email protected]"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

Si la autenticación del usuario no se realiza adecuadamente, puede mostrar un mensaje de error en el widget de autenticación. Para hacerlo, en la respuesta a la solicitud de creación de un usuario, transmita el objeto error con los siguientes detalles:
- En el parámetro de code, especifique un código de error; por ejemplo, 011-002.
- En el parámetro de description, facilite el texto del mensaje de error.
El servidor de Xsolla Login genera un JWT de usuario.
El usuario es redirigido a la login_url con un parámetro de consulta token. El parámetro token contiene el JWT de usuario.

Se crea un nuevo usuario si no hay datos de usuario escritos en la base de datos de Xsolla.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'labelBoxBkgColor': 'transparent', 'labelBoxBorderColor': '#8ADCEC', 'altSectionBkgColor': 'transparent' }, 'sequence': {'noteMargin': 50}}}%%
sequenceDiagram
  participant U as Usuario
  participant YC as Su cliente
  participant XL as Servidor de Xsolla Login
  participant YS as Su servidor
  U->>YC: Introduce el nombre de usuario y la contraseña
  YC->>XL: Envía una solicitud de autenticación de usuario
  XL->>YS: Envía un webhook
  alt Autenticación realizada correctamente
    YS-->>XL: Devuelve un código HTTP 2xx y un cuerpo opcional
    opt El cuerpo de la respuesta contiene los datos del usuario
      activate XL
      note right of XL: Guarda los atributos y añade información a los datos del usuario
      deactivate XL
    end
    XL-->>YC: Devuelve un código de autorización
    YC->>XL: Envía una solicitud para generar el JWT del usuario
    XL-->>YC: Devuelve el JWT del usuario y el token de actualización
    YC-->>U: Completa la autenticación
  else Autenticación fallida
    YS-->>XL: Devuelve un error
    XL-->>YC: Devuelve un error de autenticación
    YC-->>U: Muestra un mensaje de error
  end

El cliente envía la solicitud Auth by username and password POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- Parámetros de consulta:
  - grant_type: tipo de concesión JWT, transmitir el valor code.
  - client_id: ID de cliente OAuth 2.0.
  - state: valor que se utiliza para la autenticación adicional del usuario. Obligatorio para evitar ataques de CSRF. Se devuelve en la respuesta. Longitud permitida: de 1 a 8 caracteres.
- Parámetros del cuerpo:
  - username: nombre de usuario. Longitud permitida: de 3 a 255 caracteres.
  - password: contraseña de usuario. Longitud permitida: de 6 a 100 caracteres.
El servidor de Xsolla Login envía un webhook a la URL de verificación de usuario. La respuesta debe tener el formato descrito en este flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

Para asignar campos JSON a propiedades de perfil de usuario en Xsolla y configurar la vinculación de cuentas por ID de usuario en su servidor, siga las instrucciones.

Ejemplo de webhook de URL de verificación del usuario:

Copy

Full screen

Small screen

http

1POST https://your.hostname/your_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email":"[email protected]",
7  "password":"123456",
8  "username":"[email protected]"
9}

1curl --request POST \
2  --url 'https://your.hostname/your_authentication_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"email":"[email protected]","password":"123456","username":"[email protected]"}'

Ejemplo de respuesta a un webhook con atributos de usuario:

Copy

Full screen

Small screen

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

Ejemplo de respuesta a un webhook con un objeto JSON:

Copy

Full screen

Small screen

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "[email protected]"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

Si la autenticación del usuario no se realiza adecuadamente, puede mostrar un mensaje de error en el widget de autenticación. Para hacerlo, en la respuesta a la solicitud de creación de un usuario, transmita el objeto error con los siguientes detalles:
- En el parámetro de code, especifique un código de error; por ejemplo, 011-002.
- En el parámetro de description, facilite el texto del mensaje de error.
El servidor de Xsolla Login genera un JWT de usuario.
El usuario es redirigido a la login_url con un parámetro de consulta token. El parámetro token contiene el JWT de usuario.

Se crea un nuevo usuario si no hay datos de usuario escritos en la base de datos de Xsolla.

Autenticación sin contraseña mediante número de teléfono

El escenario de interacción depende del protocolo de autenticación que elija: JWT u OAuth 2.0.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'labelBoxBkgColor': 'transparent', 'labelBoxBorderColor': '#8ADCEC', 'altSectionBkgColor': 'transparent' }, 'sequence': {'noteMargin': 50}}}%%
sequenceDiagram
  participant U as Usuario
  participant YC as Su cliente
  participant XL as Servidor de Xsolla Login
  participant YS as Su servidor
  U->>YC: Introduce el número de teléfono
  YC->>XL: Envía una solicitud para iniciar la autenticación mediante el número de teléfono
  XL-->>U: Envía un SMS con el código de confirmación
  U->>YC: Introduce el código de confirmación
  YC->>XL: Envía una solicitud para completar la autenticación mediante el número de teléfono
  XL->>YS: Envía un webhook
  alt Autenticación realizada correctamente
    YS-->>XL: Devuelve un código HTTP 2xx y un cuerpo opcional
    opt El cuerpo de la respuesta contiene los datos del usuario
      activate XL
      note right of XL: Guarda los atributos y añade información a los datos del usuario
      deactivate XL
    end
    XL-->>YC: Devuelve el JWT del usuario
    YC-->>U: Completa la autenticación
  else Autenticación fallida
    YS-->>XL: Devuelve un error
    XL-->>YC: Devuelve un error de autenticación
    YC-->>U: Muestra un mensaje de error
  end

El cliente abre un formulario de autenticación para que el usuario pueda introducir su número de teléfono.
El usuario introduce su número de teléfono.
El cliente envía la solicitud Start auth by phone number POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: ID del proyecto de Login en Cuenta del editor.
- El parámetro del cuerpo phone_number: número de teléfono del usuario.
El cliente muestra un campo para que el usuario pueda rellenar el código de verificación.
El usuario introduce el código de verificación recibido.

El cliente del juego envía la solicitud de Complete auth by phone number POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: el ID del proyecto de Login en Cuenta del editor.
- Parámetros del cuerpo:
  - code - código de confirmación.
  - phone_number - número de teléfono del usuario.
  - operation_id - ID del código de confirmación.
Si es la primera autorización del usuario, el servidor de Xsolla Login envía un webhook a URL de inicio de sesión sin contraseña. La respuesta debe tener el formato descrito en este flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.
Si la autenticación del usuario no se supera, puede proporcionar un mensaje de error que se mostrará en el widget de autenticación. Para ello, en la respuesta a la solicitud de creación del usuario, transmita el objeto error con los siguientes detalles:
- En el parámetro de code, especifique un código de error; por ejemplo, 011-002.
- En el parámetro de description facilite el texto del mensaje de error.

El cliente abre un formulario de autenticación para que el usuario pueda introducir su número de teléfono.
El usuario introduce su número de teléfono.
El cliente envía la solicitud Start auth by phone number POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: ID del proyecto de inicio de sesión en la cuenta para juegos en móviles.
- El parámetro del cuerpo phone_number: número de teléfono del usuario.
El cliente muestra un campo para que el usuario pueda rellenar el código de verificación.
El usuario introduce el código de verificación recibido.

El cliente del juego envía la solicitud de Complete auth by phone number POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: el ID del proyecto de inicio de sesión en la cuenta para juegos en móviles.
- Parámetros del cuerpo:
  - code - código de confirmación.
  - phone_number - número de teléfono del usuario.
  - operation_id - ID del código de confirmación.
Si es la primera autorización del usuario, el servidor de Xsolla Login envía un webhook a URL de inicio de sesión sin contraseña. La respuesta debe tener el formato descrito en este flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.
Si la autenticación del usuario no se supera, puede proporcionar un mensaje de error que se mostrará en el widget de autenticación. Para ello, en la respuesta a la solicitud de creación del usuario, transmita el objeto error con los siguientes detalles:
- En el parámetro de code, especifique un código de error; por ejemplo, 011-002.
- En el parámetro de description facilite el texto del mensaje de error.

El cliente abre un formulario de autenticación para que el usuario pueda introducir su número de teléfono.
El usuario introduce su número de teléfono.
El cliente envía la solicitud Start auth by phone number POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId — ID del proyecto de Login en tu cuenta.
- El parámetro del cuerpo phone_number — número de teléfono del usuario.
El cliente muestra un campo para que el usuario pueda rellenar el código de verificación.
El usuario introduce el código de verificación recibido.

El cliente envía la solicitud Complete auth by phone number POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId — ID del proyecto de Login en tu cuenta.
- Parámetros del cuerpo:
  - code — código de confirmación.
  - phone_number — número de teléfono del usuario.
  - operation_id — ID del código de confirmación.
Si es la primera autorización del usuario, el servidor de Xsolla Login envía un webhook a la Passwordless login URL. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, puedes especificar una lista de atributos de usuario y/o cualquier objeto JSON necesario. El objeto JSON que proporciones en la respuesta se registra en el campo partner_data del JWT del usuario.
Si la autenticación del usuario no es exitosa, puedes proporcionar un mensaje de error que se mostrará en el widget de autenticación. Para ello, en la respuesta a la solicitud de creación del usuario, pasa el objeto error con los siguientes detalles:
- En el parámetro code, especifica un código de error, por ejemplo 011-002.
- En el parámetro description, proporciona el texto del mensaje de error.

Para asignar campos JSON a propiedades de perfil de usuario en Xsolla y configurar la vinculación de cuentas por ID de usuario en su servidor, siga las instrucciones.

Ejemplo de webhook:

Copy

Full screen

Small screen

http

1POST https://your.hostname/your_phone_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "login": "+12025550140",
7  "type": "phone"
8}

1curl --request POST \
2  --url 'https://your.hostname/your_phone_authentication_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"login":"+12025550140","type":"phone"}'

Ejemplo de respuesta a un webhook con atributos de usuario:

Copy

Full screen

Small screen

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

Ejemplo de respuesta a un webhook con un objeto JSON:

Copy

Full screen

Small screen

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "[email protected]"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'labelBoxBkgColor': 'transparent', 'labelBoxBorderColor': '#8ADCEC', 'altSectionBkgColor': 'transparent' }, 'sequence': {'noteMargin': 50}}}%%
sequenceDiagram
  participant U as Usuario
  participant YC as Su cliente
  participant XL as Servidor de Xsolla Login
  participant YS as Su servidor
  U->>YC: Introduce el número de teléfono
  YC->>XL: Envía una solicitud para iniciar la autenticación mediante el número de teléfono
  XL-->>U: Envía un SMS con el código de confirmación
  U->>YC: Introduce el código de confirmación
  YC->>XL: Envía una solicitud para completar la autenticación mediante el número de teléfono
  XL->>YS: Envía un webhook
  alt Autenticación realizada correctamente
    YS-->>XL: Devuelve un código HTTP 2xx y un cuerpo opcional
    opt El cuerpo de la respuesta contiene los datos del usuario
      activate XL
      note right of XL: Guarda los atributos y añade información a los datos del usuario
      deactivate XL
    end
    XL-->>YC: Devuelve un código de autorización
    YC->>XL: Envía una solicitud para generar el JWT del usuario
    XL-->>YC: Devuelve el JWT del usuario y el token de actualización
    YC-->>U: Completa la autenticación
  else Autenticación fallida
    YS-->>XL: Devuelve un error
    XL-->>YC: Devuelve un error de autenticación
    YC-->>U: Muestra un mensaje de error
  end

El cliente abre un formulario de autenticación para que el usuario pueda introducir su número de teléfono.
El usuario introduce su número de teléfono.
El cliente envía la solicitud Start auth by phone number POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- Parámetros de consulta:
  - response_type: tipo de concesión JWT, transmitir el valor code.
  - client_id: ID de cliente OAuth 2.0.
  - state: valor que se utiliza para la autenticación adicional del usuario. Obligatorio para prevenir los ataques de CSRF. Se devuelve en la respuesta. Longitud permitida: de 1 a 8 caracteres.
- El parámetro del cuerpo phone_number: número de teléfono del usuario.
El cliente muestra un campo para que el usuario pueda rellenar el código de verificación.
El usuario introduce el código de verificación recibido.

El cliente envía la solicitud de Complete auth by phone number POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta client_id: ID de cliente OAuth 2.0.
- Parámetros del cuerpo:
  - code: código de confirmación.
  - phone_number: número de teléfono del usuario.
  - operation_id: ID de código de confirmación.
Si es la primera autorización del usuario, el servidor de Xsolla Login envía un webhook a URL de inicio de sesión sin contraseña. La respuesta debe tener el formato descrito en este flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.
Si la autenticación del usuario no se supera, puede proporcionar un mensaje de error que se mostrará en el widget de autenticación. Para ello, en la respuesta a la solicitud de creación del usuario, transmita el objeto error con los siguientes detalles:
- En el parámetro de code, especifique un código de error, por ejemplo, 011-002.
- En el parámetro de description, facilite el texto del mensaje de error.

Para asignar campos JSON a propiedades de perfil de usuario en Xsolla y configurar la vinculación de cuentas por ID de usuario en su servidor, siga las instrucciones.

Ejemplo de webhook:

Copy

Full screen

Small screen

http

1POST https://your.hostname/your_phone_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "login": "+12025550140",
7  "type": "phone"
8}

1curl --request POST \
2  --url 'https://your.hostname/your_phone_authentication_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"login":"+12025550140","type":"phone"}'

Ejemplo de respuesta a un webhook con atributos de usuario:

Copy

Full screen

Small screen

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

Ejemplo de respuesta a un webhook con un objeto JSON:

Copy

Full screen

Small screen

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "[email protected]"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

Autenticación sin contraseña con correo electrónico

El escenario de interacción depende del protocolo de autenticación que elija: JWT u OAuth 2.0.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'labelBoxBkgColor': 'transparent', 'labelBoxBorderColor': '#8ADCEC', 'altSectionBkgColor': 'transparent' }, 'sequence': {'noteMargin': 50}}}%%
sequenceDiagram
  participant U as Usuario
  participant YC as Su cliente
  participant XL as Servidor de Xsolla Login
  participant YS as Su servidor
  U->>YC: Introduce el correo electrónico
  YC->>XL: Envía una solicitud para iniciar la autenticación por correo electrónico
  XL-->>U: Envía un correo electrónico con el código de confirmación
  U->>YC: Introduce el código de confirmación
  YC->>XL: Envía una solicitud para completar la autenticación por correo electrónico
  XL->>YS: Envía un webhook
  alt Autenticación realizada correctamente
    YS-->>XL: Devuelve un código HTTP 2xx y un cuerpo opcional
    opt El cuerpo de la respuesta contiene los datos del usuario
      activate XL
      note right of XL: Guarda los atributos y añade información a los datos del usuario
      deactivate XL
    end
    XL-->>YC: Devuelve el JWT del usuario
    YC-->>U: Completa la autenticación
  else Autenticación fallida
    YS-->>XL: Devuelve un error
    XL-->>YC: Devuelve un error de autenticación
    YC-->>U: Muestra un mensaje de error
  end

El cliente abre un formulario de autenticación para que el usuario pueda introducir su dirección de correo electrónico.
El usuario introduce su dirección de correo electrónico.
El cliente envía la solicitud Start auth by email POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: ID del proyecto de Login en Cuenta del editor.
- El parámetro del cuerpo email: dirección de correo electrónico del usuario.
El cliente muestra un campo para que el usuario pueda rellenar el código de verificación.
El usuario introduce el código de verificación recibido.

El cliente envía la solicitud de Complete auth by email POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: ID del proyecto de Login en Cuenta del editor.
- Parámetros del cuerpo:
  - code: código de confirmación
  - email: dirección de correo electrónico del usuario
  - operation_id: ID del código de confirmación
Si es la primera autorización del usuario, el servidor de Xsolla Login envía un webhook a URL de inicio de sesión sin contraseña. La respuesta debe tener el formato descrito en este flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.
Si la autenticación del usuario no se supera, puede proporcionar un mensaje de error que se mostrará en el widget de autenticación. Para ello, en la respuesta a la solicitud de creación del usuario, transmita el objeto error con los siguientes detalles:
- En el parámetro de code, especifique un código de error, por ejemplo, 011-002.
- En el parámetro de description facilite el texto del mensaje de error.

El cliente abre un formulario de autenticación para que el usuario pueda introducir su dirección de correo electrónico.
El usuario introduce su dirección de correo electrónico.
El cliente envía la solicitud Start auth by email POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: ID del proyecto de inicio de sesión en la cuenta para juegos en móviles.
- El parámetro del cuerpo email: dirección de correo electrónico del usuario.
El cliente muestra un campo para que el usuario pueda rellenar el código de verificación.
El usuario introduce el código de verificación recibido.

El cliente envía la solicitud de Complete auth by email POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: ID del proyecto de inicio de sesión en la cuenta para juegos en móviles.
- Parámetros del cuerpo:
  - code: código de confirmación
  - email: dirección de correo electrónico del usuario
  - operation_id: ID del código de confirmación
Si es la primera autorización del usuario, el servidor de Xsolla Login envía un webhook a URL de inicio de sesión sin contraseña. La respuesta debe tener el formato descrito en este flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.
Si la autenticación del usuario no se supera, puede proporcionar un mensaje de error que se mostrará en el widget de autenticación. Para ello, en la respuesta a la solicitud de creación del usuario, transmita el objeto error con los siguientes detalles:
- En el parámetro de code, especifique un código de error, por ejemplo, 011-002.
- En el parámetro de description facilite el texto del mensaje de error.

El cliente abre un formulario de autenticación para que el usuario pueda introducir su dirección de correo electrónico.
El usuario introduce su dirección de correo electrónico.
El cliente envía la solicitud Start auth by email POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId — ID del proyecto de Login en tu cuenta.
- El parámetro del cuerpo email — dirección de correo electrónico del usuario.
El cliente muestra un campo para que el usuario pueda rellenar el código de verificación.
El usuario introduce el código de verificación recibido.

El cliente envía la solicitud Complete auth by email POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId — ID del proyecto de Login en tu cuenta.
- Parámetros del cuerpo:
  - code — código de confirmación
  - email — dirección de correo electrónico del usuario
  - operation_id — ID del código de confirmación
Si es la primera autorización del usuario, el servidor de Xsolla Login envía un webhook a la Passwordless login URL. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, puedes especificar una lista de atributos de usuario y/o cualquier objeto JSON necesario. El objeto JSON que proporciones en la respuesta se registra en el campo partner_data del JWT del usuario.
Si la autenticación del usuario no es exitosa, puedes proporcionar un mensaje de error que se mostrará en el widget de autenticación. Para ello, en la respuesta a la solicitud de creación del usuario, pasa el objeto error con los siguientes detalles:
- En el parámetro code, especifica un código de error, por ejemplo 011-002.
- En el parámetro description, proporciona el texto del mensaje de error.

Para asignar campos JSON a propiedades de perfil de usuario en Xsolla y configurar la vinculación de cuentas por ID de usuario en su servidor, siga las instrucciones.

Ejemplo de webhook:

Copy

Full screen

Small screen

http

1POST https://your.hostname/your_email_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email": "[email protected]",
7  "type": "email"
8}

1curl --request POST \
2  --url 'https://your.hostname/your_email_authentication_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"email": "[email protected]","type": "email"}'

Ejemplo de respuesta a un webhook con atributos de usuario:

Copy

Full screen

Small screen

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

Ejemplo de respuesta a un webhook con un objeto JSON:

Copy

Full screen

Small screen

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "[email protected]"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'labelBoxBkgColor': 'transparent', 'labelBoxBorderColor': '#8ADCEC', 'altSectionBkgColor': 'transparent' }, 'sequence': {'noteMargin': 50}}}%%
sequenceDiagram
  participant U as Usuario
  participant YC as Su cliente
  participant XL as Servidor de Xsolla Login
  participant YS as Su servidor
  U->>YC: Introduce el correo electrónico
  YC->>XL: Envía una solicitud para iniciar la autenticación por correo electrónico
  XL-->>U: Envía un correo electrónico con el código de confirmación
  U->>YC: Introduce el código de confirmación
  YC->>XL: Envía una solicitud para completar la autenticación por correo electrónico
  XL->>YS: Envía un webhook
  alt Autenticación realizada correctamente
    YS-->>XL: Devuelve un código HTTP 2xx y un cuerpo opcional
    opt El cuerpo de la respuesta contiene los datos del usuario
      activate XL
      note right of XL: Guarda los atributos y añade información a los datos del usuario
      deactivate XL
    end
    XL-->>YC: Devuelve un código de autorización
    YC->>XL: Envía una solicitud para generar el JWT del usuario
    XL-->>YC: Devuelve el JWT del usuario y el token de actualización
    YC-->>U: Completa la autenticación
  else Autenticación fallida
    YS-->>XL: Devuelve un error
    XL-->>YC: Devuelve un error de autenticación
    YC-->>U: Muestra un mensaje de error
  end

El cliente abre un formulario de autenticación para que el usuario pueda introducir su correo electrónico.
El usuario introduce su correo electrónico.
El cliente envía la solicitud Start auth by email POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- Parámetros de consulta:
  - response_type: tipo de concesión JWT, transmitir el valor code.
  - client_id: ID de cliente OAuth 2.0.
  - state: valor que se utiliza para la autenticación adicional del usuario. Obligatorio para prevenir ataques de CSRF. Se devuelve en la respuesta. Longitud permitida: de 1 a 8 caracteres.
- El parámetro del cuerpo email: dirección de correo electrónico del usuario.
El cliente muestra un campo para que el usuario pueda rellenar el código de verificación.
El usuario introduce el código de verificación recibido.

El cliente envía la solicitud de Complete auth by email POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta client_id: ID de cliente OAuth 2.0.
- Parámetros del cuerpo:
  - code: código de confirmación.
  - email: correo electrónico del usuario.
  - operation_id: ID de código de confirmación.
Si es la primera autorización del usuario, el servidor de Xsolla Login envía un webhook a URL de inicio de sesión sin contraseña. La respuesta debe tener el formato descrito en este flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.
Si la autenticación del usuario no se supera, puede proporcionar un mensaje de error que se mostrará en el widget de autenticación. Para ello, en la respuesta a la solicitud de creación del usuario, transmita el objeto error con los siguientes detalles:
- En el parámetro de code, especifique un código de error, por ejemplo, 011-002.
- En el parámetro de description, facilite el texto del mensaje de error.

Ejemplo de webhook:

Para asignar campos JSON a propiedades de perfil de usuario en Xsolla y configurar la vinculación de cuentas por ID de usuario en su servidor, siga las instrucciones.

Copy

Full screen

Small screen

http

1POST https://your.hostname/your_email_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email": "[email protected]",
7  "type": "email"
8}

1curl --request POST \
2  --url 'https://your.hostname/your_email_authentication_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"email": "[email protected]","type": "email"}'

Ejemplo de respuesta a un webhook con atributos de usuario:

Copy

Full screen

Small screen

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

Ejemplo de respuesta a un webhook con un objeto JSON:

Copy

Full screen

Small screen

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "[email protected]"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

Autenticación mediante redes sociales

El escenario de interacción depende del protocolo de autenticación que elija: JWT u OAuth 2.0.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'labelBoxBkgColor': 'transparent', 'labelBoxBorderColor': '#8ADCEC', 'altSectionBkgColor': 'transparent' }, 'sequence': {'noteMargin': 50}}}%%
sequenceDiagram
  participant U as Usuario
  participant YC as Su cliente
  participant XL as Servidor de Xsolla Login
  participant YS as Su servidor
  participant SN as Red social
  U->>YC: Selecciona una red social
  YC->>XL: Envía una solicitud de autenticación mediante red social
  XL->>SN: Redirige al usuario a la página de inicio de sesión de la red social
  SN-->>XL: Devuelve los datos del usuario de la red social
  XL->>YS: Envía un webhook
  alt Autenticación realizada correctamente
    YS-->>XL: Devuelve un código HTTP 2xx y un cuerpo opcional
    opt El cuerpo de la respuesta contiene los datos del usuario
      activate XL
      note right of XL: Guarda los atributos y añade información a los datos del usuario
      deactivate XL
    end
    XL-->>YC: Devuelve el JWT del usuario
    YC-->>U: Completa la autenticación
  else Autenticación fallida
    YS-->>XL: Devuelve un error
    XL-->>YC: Devuelve un error de autenticación
    YC-->>U: Muestra un mensaje de error
  end

Para obtener los datos del usuario al autenticarse a través de redes sociales, especifique la URL de inicio de sesión mediante red social en la configuración de su proyecto de Login en Cuenta del editor (en User database > Storage > Custom storage). A esta URL se envía una solicitud con los datos recibidos de la red social.

Flujo de autenticación:

El cliente envía la solicitud Auth via social network POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: ID del proyecto de Login en Cuenta del editor.
- El parámetro de ruta de provider_name: nombre de la red social conectada a Login en Cuenta de editor. Puede ser: amazon, apple, xsolla, baidu, battlenet, discord, epicgames, facebook, github, google, kakao, linkedin, mailru, microsoft, msn, naver, ok, paypal, qq, reddit, steam, twitch, twitter, vimeo, vk, wechat, weibo, xbox, yahoo, yandex, youtube.
El usuario inicia sesión en una red social.
El servidor de Xsolla Login procesa los datos del usuario recibidos de la red social y envía una solicitud a la URL de inicio de sesión mediante red social. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

Para obtener los datos del usuario al autenticarse mediante redes sociales, especifique la Social Login URL en la configuración de su proyecto de Login en la cuenta para juegos en móviles (en User database > Storage > Custom storage). A esta URL se envía una solicitud con los datos recibidos de la red social.

Flujo de autenticación:

El cliente envía la solicitud Auth via social network POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: ID del proyecto de inicio de sesión en la cuenta para juegos en móviles.
- El parámetro de ruta de provider_name: nombre de la red social conectada a Login en la cuenta para juegos en móviles. Puede ser: amazon, apple, xsolla, baidu, battlenet, discord, epicgames, facebook, github, google, kakao, linkedin, mailru, microsoft, msn, naver, ok, paypal, qq, reddit, steam, twitch, twitter, vimeo, vk, wechat, weibo, xbox, yahoo, yandex, youtube.
El usuario inicia sesión en una red social.
El servidor de Xsolla Login procesa los datos del usuario recibidos de la red social y envía una solicitud a la URL de inicio de sesión mediante red social. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

Para obtener los datos del usuario al autenticarse a través de redes sociales, especifica la URL de inicio de sesión mediante red social en la configuración de tu proyecto de Login en la cuenta (en la sección User database > Storage > Custom storage). A esta URL se envía una solicitud con los datos recibidos de la red social.

Flujo de autenticación:

El cliente envía la solicitud Auth via social network POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId — ID del proyecto de Login en tu cuenta.
- El parámetro de ruta provider_name — nombre de la red social conectada a Login en tu cuenta. Puede ser: amazon, apple, xsolla, baidu, battlenet, discord, epicgames, facebook, github, google, kakao, linkedin, mailru, microsoft, msn, naver, ok, paypal, qq, reddit, steam, twitch, twitter, vimeo, vk, wechat, weibo, xbox, yahoo, yandex, youtube.
El usuario inicia sesión en una red social.
El servidor de Xsolla Login procesa los datos del usuario recibidos de la red social y envía un webhook a la Social Login URL. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, puedes especificar una lista de atributos de usuario y/o cualquier objeto JSON necesario. El objeto JSON que proporciones en la respuesta se registra en el campo partner_data del JWT del usuario.

Flujo de autenticación:

El cliente envía la solicitud Auth via social network POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId — ID del proyecto de Login en tu cuenta.
- El parámetro de ruta provider_name — nombre de la red social conectada a Login en tu cuenta. Puede ser: amazon, apple, xsolla, baidu, battlenet, discord, epicgames, facebook, github, google, kakao, linkedin, mailru, microsoft, msn, naver, ok, paypal, qq, reddit, steam, twitch, twitter, vimeo, vk, wechat, weibo, xbox, yahoo, yandex, youtube.
El usuario inicia sesión en una red social.
El servidor de Xsolla Login procesa los datos del usuario recibidos de la red social y envía un webhook a la Social Login URL. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, puedes especificar una lista de atributos de usuario y/o cualquier objeto JSON necesario. El objeto JSON que proporciones en la respuesta se registra en el campo partner_data del JWT del usuario.

Flujo de autenticación:

El cliente envía la solicitud Auth via social network POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId — ID del proyecto de Login en tu cuenta.
- El parámetro de ruta provider_name — nombre de la red social conectada a Login en tu cuenta. Puede ser: amazon, apple, xsolla, baidu, battlenet, discord, epicgames, facebook, github, google, kakao, linkedin, mailru, microsoft, msn, naver, ok, paypal, qq, reddit, steam, twitch, twitter, vimeo, vk, wechat, weibo, xbox, yahoo, yandex, youtube.
El usuario inicia sesión en una red social.
El servidor de Xsolla Login procesa los datos del usuario recibidos de la red social y envía un webhook a la Social Login URL. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, puedes especificar una lista de atributos de usuario y/o cualquier objeto JSON necesario. El objeto JSON que proporciones en la respuesta se registra en el campo partner_data del JWT del usuario.

Para asignar campos JSON a propiedades de perfil de usuario en Xsolla y configurar la vinculación de cuentas por ID de usuario en su servidor, siga las instrucciones.

Los datos del usuario se transmiten en el encabezado Authorization como un token de puerta de enlace temporal (un token de servidor con “request_type”: “gateway_token”).

Campos principales del token de puerta de enlace:

Reclamación	Tipo	Descripción
exp	Marca de tiempo Unix	La fecha y hora de expiración del JWT. El ciclo de vida del JWT es de 7 minutos. Obligatorio.
iat	Marca de tiempo Unix	La fecha y la hora en que se emitió el JWT. Obligatorio.
iss	string	El servicio que firmó el JWT: `https://login.xsolla.com`. Obligatorio.
request_type	string	Constante: `gateway_request`. Obligatorio.
xsolla_login_project_id	string (cadena) (UUID)	Su ID de proyecto de Login en Cuenta del editor. Obligatorio.
email	string	Dirección de correo electrónico del usuario.
sub	string (cadena) (UUID)	ID de usuario escrito en el lado del servidor de Xsolla Login. Obligatorio.
username	string	Nombre de usuario.
provider	string	Nombre de la red social utilizada para la autenticación. Obligatorio.
id	string	ID de usuario en una red social. Obligatorio.
social_access_token	string	Token de acceso de la red social a través de la cual se autenticó el usuario. Para activar la transmisión de esta notificación, contacte con su gestor del éxito del cliente o envíe un correo electrónico a [email protected].
partner_data	string	Datos de cualquier tipo devueltos por su servidor en el cuerpo de la respuesta durante la autenticación. Para activar la transmisión de esta notificación, contacte con su gestor del éxito del cliente o envíe un correo electrónico a [email protected].

Reclamación	Tipo	Descripción
exp	Marca de tiempo Unix	La fecha y hora de expiración del JWT. El ciclo de vida del JWT es de 7 minutos. Obligatorio.
iat	Marca de tiempo Unix	La fecha y la hora en que se emitió el JWT. Obligatorio.
iss	string	El servicio que firmó el JWT: `https://login.xsolla.com`. Obligatorio.
request_type	string	Constante: `gateway_request`. Obligatorio.
xsolla_login_project_id	string (cadena) (UUID)	Tu ID de proyecto de Login en la cuenta. Obligatorio.
email	string	Dirección de correo electrónico del usuario.
sub	string (cadena) (UUID)	ID de usuario escrito en el lado del servidor de Xsolla Login. Obligatorio.
username	string	Nombre de usuario.
provider	string	Nombre de la red social utilizada para la autenticación. Obligatorio.
id	string	ID de usuario en una red social. Obligatorio.
social_access_token	string	Token de acceso de la red social a través de la cual se autenticó el usuario. Para activar la transmisión de esta notificación, contacte con su gestor del éxito del cliente o envíe un correo electrónico a [email protected].
partner_data	string	Datos de cualquier tipo devueltos por su servidor en el cuerpo de la respuesta durante la autenticación. Para activar la transmisión de esta notificación, contacte con su gestor del éxito del cliente o envíe un correo electrónico a [email protected].

Ejemplo de carga útil de un token:

Copy

Full screen

Small screen

 1{
 2  "exp": 1573635020,
 3  "iat": 1573634600,
 4  "iss": "https://login.xsolla.com",
 5  "request_type": "gateway_request",
 6  "xsolla_login_project_id": "00000000-0000-0000-0000-000000000000",
 7  "sub": "00000000-0000-0000-0000-000000000000",
 8  "email": "[email protected]",
 9  "username": "Smith707",
10  "provider": "google",
11  "id": "123",
12}

Ejemplo de webhook de URL de inicio de sesión mediante red social:

Copy

Full screen

Small screen

http

1POST https://your.hostname/your_social_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{}

1curl --request POST \
2  --url 'https://your.hostname/your_social_authentication_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json'

Ejemplo de respuesta a un webhook con atributos de usuario:

Copy

Full screen

Small screen

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

Ejemplo de respuesta a un webhook con un objeto JSON:

Copy

Full screen

Small screen

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "[email protected]"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

Si la autenticación del usuario no se realiza adecuadamente, puede facilitar un mensaje de error que se mostrará en el widget de autenticación. Para hacerlo, en la respuesta a la solicitud de creación de un usuario, transmita el objeto error con los siguientes detalles:
- En el parámetro de code, especifique un código de error; por ejemplo, 011-002.
- En el parámetro de description, facilite el texto del mensaje de error.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'labelBoxBkgColor': 'transparent', 'labelBoxBorderColor': '#8ADCEC', 'altSectionBkgColor': 'transparent' }, 'sequence': {'noteMargin': 50}}}%%
sequenceDiagram
  participant U as Usuario
  participant YC as Su cliente
  participant XL as Servidor de Xsolla Login
  participant YS as Su servidor
  participant SN as Red social
  U->>YC: Selecciona una red social
  YC->>XL: Envía una solicitud de autenticación mediante red social
  XL->>SN: Redirige al usuario a la página de inicio de sesión de la red social
  SN-->>XL: Devuelve los datos del usuario de la red social
  XL->>YS: Envía un webhook
  alt Autenticación realizada correctamente
    YS-->>XL: Devuelve un código HTTP 2xx y un cuerpo opcional
    opt El cuerpo de la respuesta contiene los datos del usuario
      activate XL
      note right of XL: Guarda los atributos y añade información a los datos del usuario
      deactivate XL
    end
    XL-->>YC: Devuelve un código de autorización
    YC->>XL: Envía una solicitud para generar el JWT del usuario
    XL-->>YC: Devuelve el JWT del usuario y el token de actualización
    YC-->>U: Completa la autenticación
  else Autenticación fallida
    YS-->>XL: Devuelve un error
    XL-->>YC: Devuelve un error de autenticación
    YC-->>U: Muestra un mensaje de error
  end

Flujo de autenticación:

El cliente envía la solicitud Auth via social network POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- Parámetros de consulta:
  - response_type: tipo de concesión JWT, transmitir el valor code.
  - client_id: ID de cliente OAuth 2.0.
  - state: valor que se utiliza para la autenticación adicional del usuario. Obligatorio para prevenir ataques de CSRF. Se devuelve en la respuesta. Longitud permitida: de 1 a 8 caracteres.
- El parámetro de ruta de provider_name: nombre de la red social conectada a Login en Cuenta de editor. Puede ser: amazon, apple, xsolla, baidu, battlenet, discord, epicgames, facebook, github, google, kakao, linkedin, mailru, microsoft, msn, naver, ok, paypal, qq, reddit, steam, twitch, twitter, vimeo, vk, wechat, weibo, xbox, yahoo, yandex, youtube.
El usuario inicia sesión en una red social.
El servidor de Xsolla Login procesa los datos del usuario recibidos de la red social y envía una solicitud a la URL de inicio de sesión mediante red social. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

Flujo de autenticación:

El cliente envía la solicitud Auth via social network POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- Parámetros de consulta:
  - response_type: tipo de concesión JWT, transmitir el valor code.
  - client_id: ID de cliente OAuth 2.0.
  - state: valor que se utiliza para la autenticación adicional del usuario. Obligatorio para prevenir ataques de CSRF. Se devuelve en la respuesta. Longitud permitida: de 1 a 8 caracteres.
- El parámetro de ruta de provider_name: nombre de la red social conectada a Login en la cuenta para juegos en móviles. Puede ser: amazon, apple, xsolla, baidu, battlenet, discord, epicgames, facebook, github, google, kakao, linkedin, mailru, microsoft, msn, naver, ok, paypal, qq, reddit, steam, twitch, twitter, vimeo, vk, wechat, weibo, xbox, yahoo, yandex, youtube.
El usuario inicia sesión en una red social.
El servidor de Xsolla Login procesa los datos del usuario recibidos de la red social y envía una solicitud a la URL de inicio de sesión mediante red social. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

Flujo de autenticación:

El cliente envía la solicitud Auth via social network POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId — ID del proyecto de Login en tu cuenta.
- El parámetro de ruta provider_name — nombre de la red social conectada a Login en tu cuenta. Puede ser: amazon, apple, xsolla, baidu, battlenet, discord, epicgames, facebook, github, google, kakao, linkedin, mailru, microsoft, msn, naver, ok, paypal, qq, reddit, steam, twitch, twitter, vimeo, vk, wechat, weibo, xbox, yahoo, yandex, youtube.
El usuario inicia sesión en una red social.
El servidor de Xsolla Login procesa los datos del usuario recibidos de la red social y envía un webhook a la Social Login URL. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, puedes especificar una lista de atributos de usuario y/o cualquier objeto JSON necesario. El objeto JSON que proporciones en la respuesta se registra en el campo partner_data del JWT del usuario.

Flujo de autenticación:

El cliente envía la solicitud Auth via social network POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId — ID del proyecto de Login en tu cuenta.
- El parámetro de ruta provider_name — nombre de la red social conectada a Login en tu cuenta. Puede ser: amazon, apple, xsolla, baidu, battlenet, discord, epicgames, facebook, github, google, kakao, linkedin, mailru, microsoft, msn, naver, ok, paypal, qq, reddit, steam, twitch, twitter, vimeo, vk, wechat, weibo, xbox, yahoo, yandex, youtube.
El usuario inicia sesión en una red social.
El servidor de Xsolla Login procesa los datos del usuario recibidos de la red social y envía un webhook a la Social Login URL. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, puedes especificar una lista de atributos de usuario y/o cualquier objeto JSON necesario. El objeto JSON que proporciones en la respuesta se registra en el campo partner_data del JWT del usuario.

Flujo de autenticación:

El cliente envía la solicitud Auth via social network POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId — ID del proyecto de Login en tu cuenta.
- El parámetro de ruta provider_name — nombre de la red social conectada a Login en tu cuenta. Puede ser: amazon, apple, xsolla, baidu, battlenet, discord, epicgames, facebook, github, google, kakao, linkedin, mailru, microsoft, msn, naver, ok, paypal, qq, reddit, steam, twitch, twitter, vimeo, vk, wechat, weibo, xbox, yahoo, yandex, youtube.
El usuario inicia sesión en una red social.
El servidor de Xsolla Login procesa los datos del usuario recibidos de la red social y envía un webhook a la Social Login URL. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, puedes especificar una lista de atributos de usuario y/o cualquier objeto JSON necesario. El objeto JSON que proporciones en la respuesta se registra en el campo partner_data del JWT del usuario.

Para asignar campos JSON a propiedades de perfil de usuario en Xsolla y configurar la vinculación de cuentas por ID de usuario en su servidor, siga las instrucciones.

Los datos del usuario se transmiten en el encabezado Authorization como un token de puerta de enlace temporal (un token de servidor con “request_type”: “gateway_token”).

Campos principales del token de puerta de enlace:

Reclamación	Tipo	Descripción
exp	Marca de tiempo Unix	La fecha y hora de expiración del JWT. El ciclo de vida del JWT es de 7 minutos. Obligatorio.
iat	Marca de tiempo Unix	La fecha y la hora en que se emitió el JWT. Obligatorio.
iss	string	El servicio que firmó el JWT: `https://login.xsolla.com`. Obligatorio.
request_type	string	Constante: `gateway_request`. Obligatorio.
xsolla_login_project_id	string (cadena) (UUID)	Su ID de proyecto de Login en Cuenta del editor. Obligatorio.
email	string	Dirección de correo electrónico del usuario.
sub	string (cadena) (UUID)	ID de usuario escrito en el lado del servidor de Xsolla Login. Obligatorio.
username	string	Nombre de usuario.
provider	string	Nombre de la red social utilizada para la autenticación. Obligatorio.
id	string	ID de usuario en una red social. Obligatorio.
social_access_token	string	Token de acceso de la red social a través de la cual se autenticó el usuario. Para activar la transmisión de esta notificación, contacte con su gestor del éxito del cliente o envíe un correo electrónico a [email protected].
partner_data	string	Datos de cualquier tipo devueltos por su servidor en el cuerpo de la respuesta durante la autenticación. Para activar la transmisión de esta notificación, contacte con su gestor del éxito del cliente o envíe un correo electrónico a [email protected].

Reclamación	Tipo	Descripción
exp	Marca de tiempo Unix	La fecha y hora de expiración del JWT. El ciclo de vida del JWT es de 7 minutos. Obligatorio.
iat	Marca de tiempo Unix	La fecha y la hora en que se emitió el JWT. Obligatorio.
iss	string	El servicio que firmó el JWT: `https://login.xsolla.com`. Obligatorio.
request_type	string	Constante: `gateway_request`. Obligatorio.
xsolla_login_project_id	string (cadena) (UUID)	Tu ID de proyecto de Login en la cuenta. Obligatorio.
email	string	Dirección de correo electrónico del usuario.
sub	string (cadena) (UUID)	ID de usuario escrito en el lado del servidor de Xsolla Login. Obligatorio.
username	string	Nombre de usuario.
provider	string	Nombre de la red social utilizada para la autenticación. Obligatorio.
id	string	ID de usuario en una red social. Obligatorio.
social_access_token	string	Token de acceso de la red social a través de la cual se autenticó el usuario. Para activar la transmisión de esta notificación, contacte con su gestor del éxito del cliente o envíe un correo electrónico a [email protected].
partner_data	string	Datos de cualquier tipo devueltos por su servidor en el cuerpo de la respuesta durante la autenticación. Para activar la transmisión de esta notificación, contacte con su gestor del éxito del cliente o envíe un correo electrónico a [email protected].

Ejemplo de carga útil de un token:

Copy

Full screen

Small screen

 1{
 2  "exp": 1573635020,
 3  "iat": 1573634600,
 4  "iss": "https://login.xsolla.com",
 5  "request_type": "gateway_request",
 6  "xsolla_login_project_id": "00000000-0000-0000-0000-000000000000",
 7  "sub": "00000000-0000-0000-0000-000000000000",
 8  "email": "[email protected]",
 9  "username": "Smith707",
10  "provider": "google",
11  "id": "123",
12}

Ejemplo de webhook de URL de inicio de sesión mediante red social:

Copy

Full screen

Small screen

http

1POST https://your.hostname/your_social_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{}

1curl --request POST \
2  --url 'https://your.hostname/your_social_authentication_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json'

Ejemplo de respuesta a un webhook con atributos de usuario:

Copy

Full screen

Small screen

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

Ejemplo de respuesta a un webhook con un objeto JSON:

Copy

Full screen

Small screen

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "[email protected]"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

Si la autenticación del usuario no se realiza adecuadamente, puede facilitar un mensaje de error que se mostrará en el widget de autenticación. Para hacerlo, en la respuesta a la solicitud de creación de un usuario, transmita el objeto error con los siguientes detalles:
- En el parámetro de code, especifique un código de error; por ejemplo, 011-002.
- En el parámetro de description, facilite el texto del mensaje de error.

Restablecimiento de contraseña de usuario

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'labelBoxBkgColor': 'transparent', 'labelBoxBorderColor': '#8ADCEC', 'altSectionBkgColor': 'transparent' }, 'sequence': {'noteMargin': 50}}}%%
sequenceDiagram
  participant U as Usuario
  participant YC as Su cliente
  participant XL as Servidor de Xsolla Login
  participant YS as Su servidor
  U->>YC: Selecciona el botón de restablecimiento de contraseña
  YC->>XL: Envía la solicitud de restablecimiento de contraseña
  XL-->>U: Envía un correo electrónico de confirmación del restablecimiento de contraseña
  U->>XL: Selecciona el enlace de restablecimiento de contraseña
  XL-->>YC: Muestra la página de nueva contraseña
  U->>YC: Introduce la nueva contraseña
  YC->>XL: Envía la solicitud de confirmación del restablecimiento de contraseña
  XL->>YS: Envía un webhook
  alt Restablecimiento de contraseña realizado correctamente
    YS-->>XL: Devuelve un código HTTP 2xx y un cuerpo opcional
    XL-->>U: Confirma el restablecimiento de contraseña
  else Restablecimiento de contraseña fallido
    YS-->>XL: Devuelve un error
    XL-->>YC: Devuelve un error de restablecimiento de contraseña
    YC-->>U: Muestra un mensaje de error
  end

El cliente envía la solicitud Reset password POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: ID del proyecto de Login en Cuenta del editor.
- Los parámetros del cuerpo de username: nombre de usuario. Longitud permitida: de 3 ta 255 caracteres.
El servidor de Xsolla Login envía al usuario un correo electrónico de confirmación de restablecimiento de contraseña.
Tras confirmar el restablecimiento de contraseña en el correo electrónico, al usuario se le redirige a la página donde puede introducir una nueva contraseña.
El usuario introduce una nueva contraseña.
El servidor de Xsolla Login envía una solicitud a la URL de restablecimiento de contraseña.
Si el restablecimiento de la contraseña no se realiza correctamente, puede proporcionar un mensaje de error que se mostrará en el widget de autenticación. Para ello, en la respuesta a la solicitud de creación de un usuario, transmita el objeto con los siguientes detalles:
- En el parámetro code, especifique un código de error; por ejemplo, 011-002.
- En el parámetro description proporcione el texto del mensaje de error.

El cliente envía la solicitud Reset password POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId: ID del proyecto de Login en la cuenta para juegos en móviles.
- El parámetro de cuerpo username: nombre de usuario. Longitud permitida: de 3 a 255 caracteres.
El servidor de Xsolla Login envía al usuario un correo electrónico para confirmar el restablecimiento de la contraseña.
Tras confirmar el restablecimiento de contraseña en el correo electrónico, se redirige al usuario a la página donde puede introducir una contraseña nueva.
El usuario introduce una nueva contraseña.
El servidor de Xsolla Login envía un webhook a la Password reset URL.
Si el restablecimiento de la contraseña no se realiza correctamente, puede proporcionar un mensaje de error que se mostrará en el widget de autenticación. Para ello, en la respuesta a la solicitud de creación de un usuario, transmita el objeto error con los siguientes datos:
- En el parámetro code, especifique un código de error; por ejemplo, 011-002.
- En el parámetro description, proporcione el texto del mensaje de error.

El cliente envía la solicitud Reset password POST al servidor de Xsolla Login. La solicitud debe incluir los siguientes parámetros obligatorios:
- El parámetro de consulta projectId — ID del proyecto de Login en su cuenta.
- El parámetro del cuerpo username — nombre de usuario. Longitud permitida: de 3 a 255 caracteres.
El servidor de Xsolla Login envía al usuario un correo electrónico de confirmación de restablecimiento de contraseña.
Tras confirmar el restablecimiento de contraseña en el correo electrónico, el usuario es redirigido a la página donde puede introducir una nueva contraseña.
El usuario introduce una nueva contraseña.
El servidor de Xsolla Login envía un webhook a la Password reset URL.
Si el restablecimiento de la contraseña no es exitoso, puede proporcionar un mensaje de error que se mostrará en el widget de autenticación. Para ello, en la respuesta a la solicitud de creación del usuario, pase el objeto error con los siguientes detalles:
- En el parámetro code, especifique un código de error, por ejemplo 011-002.
- En el parámetro description, proporcione el texto del mensaje de error.

Ejemplo de webhook de URL de restablecimiento de contraseña:

Copy

Full screen

Small screen

http

 1POST https://your.hostname/your_reset_uri HTTP/1.1
 2Authorization: Bearer {JWT}
 3Content-Type: application/json
 4
 5{
 6  "username": "[email protected]",
 7  "fields": {
 8    "password": "NewPa$$word1"
 9  }
10}

1curl --request POST \
2  --url 'https://your.hostname/your_reset_uri' \
3  --header 'authorization: bearer_JWT' \
4  --header 'content-type: application/json' \
5  --data '{"email":"[email protected]","fields":{"password":"NewPa$$word1"}}'

Token de actualización

La actualización de tokens solo está disponible cuando se utiliza el protocolo de autenticación OAuth 2.0.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'labelBoxBkgColor': 'transparent', 'labelBoxBorderColor': '#8ADCEC', 'altSectionBkgColor': 'transparent' }, 'sequence': {'noteMargin': 50}}}%%
sequenceDiagram
  participant YC as Su cliente
  participant XL as Servidor de Xsolla Login
  participant YS as Su servidor
  YC->>XL: Envía una solicitud para actualizar el token
  XL->>YS: Envía un webhook
  YS-->>XL: Devuelve un código HTTP 2xx y un cuerpo opcional
  opt El cuerpo de la respuesta contiene los datos del usuario
    activate XL
    note right of XL: Guarda los atributos y añade información a los datos del usuario
    deactivate XL
  end
  XL-->>YC: Devuelve un JWT y un token de actualización nuevos

Cuando caduca el token de acceso, el cliente envía el punto final de la solicitud Generar JWT POST al servidor de Xsolla Login. El cuerpo de la solicitud debe incluir los siguientes parámetros:
- grant_type: tipo de concesión JWT, transmitir el valor refresh_token.
- client_id: ID de cliente OAuth 2.0.
- refresh_token: token de actualización recibido en respuesta a la solicitud de autorización de usuario.
El servidor de Xsolla Login procesa los datos de usuario recibidos de la red social y envía un webhook a URL de token de actualización. La respuesta debe tener el formato descrito en el flujo de interacción. En la respuesta, se puede especificar una lista de atributos de usuario o cualquier objeto JSON necesario. El objeto JSON que proporcione en la respuesta se registra en el campo partner_data del JWT del usuario.

Para asignar campos JSON a propiedades de perfil de usuario en Xsolla y configurar la vinculación de cuentas por ID de usuario en su servidor, siga las instrucciones.

Ejemplo de webhook:

Copy

Full screen

Small screen

1POST https://your.hostname/your_refrsh_token_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{}

Ejemplo de respuesta a un webhook con atributos de usuario:

Copy

Full screen

Small screen

 1{
 2    "attributes": [
 3      {
 4        "attr_type": "server",
 5        "key": "company",
 6        "permission": "private",
 7        "value": "facebook-promo"
 8      },
 9      {
10        "attr_type": "server",
11        "key": "custom-id",
12        "permission": "private",
13        "value": 48582
14      }
15    ]
16}

Ejemplo de respuesta a un webhook con un objeto JSON:

Copy

Full screen

Small screen

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "[email protected]"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17
18}

¡Gracias por tu mensaje!

Nos ayudará a mejorar tu experiencia.

Seguir leyendo

Enlaces útiles

Cómo conectar un almacenamiento personalizado Asignación de nombres de claves JSON a propiedades del perfil de usuario

Última actualización: 7 de Octubre de 2026

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

Contenidos

Flujo de interacción
Registro de usuarios
Autenticación mediante nombre de usuario y contraseña
Autenticación sin contraseña mediante número de teléfono
Autenticación sin contraseña con correo electrónico
Autenticación mediante redes sociales
Restablecimiento de contraseña de usuario
Token de actualización

Almacenamiento personalizado de datos de usuarios

Flujo de interacción

attr_type

key

permission

read_only

value

Registro de usuarios

Autenticación mediante nombre de usuario y contraseña

Autenticación sin contraseña mediante número de teléfono

Autenticación sin contraseña con correo electrónico

Autenticación mediante redes sociales

Restablecimiento de contraseña de usuario

Token de actualización

Seguir leyendo

Enlaces útiles