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:

1. El cliente envía solicitudes al servidor de Xsolla Login. El formato de las solicitudes se describe en Authentication methods.
2. 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 del token, siga las instrucciones. 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.
3. 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.
4. El servidor de Xsolla Login procesa una respuesta de su servidor y devuelve el token de autorización al cliente.
5. El cliente procesa la respuesta.

Si desea agregar información del usuario al JWT tras la identificación del usuario, 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.

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:

1. El cliente envía solicitudes al servidor de Xsolla Login. El formato de las solicitudes se describe en Authentication methods.
2. 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.
3. 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.

5. El servidor de Xsolla Login procesa una respuesta de su servidor y devuelve el token de autorización al cliente.
6. 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.
7. El servidor de Xsolla Login devuelve un par de JWT al cliente: un token de acceso y un token de actualización.
8. El cliente procesa la respuesta.
9. 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.

1. 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.
2. 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.

Ejemplo de webhook:

1POST https://your.hostname/your_registration_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email":"j.smith@email.com",
7  "password":"123456",
8  "username":"j.smith@email.com"
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":"j.smith@email.com","password":"123456","username":"j.smith@email.com"}'

Ejemplo de respuesta a un webhook con atributos de usuario:

 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:

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 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}

3. 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.
4. 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}.
5. 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:

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

1. 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.
2. 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.

Ejemplo de webhook:

1POST https://your.hostname/your_registration_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email":"j.smith@email.com",
7  "password":"123456",
8  "username":"j.smith@email.com"
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":"j.smith@email.com","password":"123456","username":"j.smith@email.com"}'

Ejemplo de respuesta a un webhook con atributos de usuario:

 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:

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 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}

3. 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.
4. 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}.
5. 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:

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

1. 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.
2. 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.

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

1POST https://your.hostname/your_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email":"j.smith@email.com",
7  "password":"123456",
8  "username":"j.smith@email.com"
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":"j.smith@email.com","password":"123456","username":"j.smith@email.com"}'

Ejemplo de respuesta a un webhook con atributos de usuario:

 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:

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 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}

3. 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.
4. El servidor de Xsolla Login genera un JWT de usuario.
5. El usuario es redirigido a la login_url con un parámetro de consulta token. El parámetro token contiene el JWT de usuario.

1. 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.
2. 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.

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

1POST https://your.hostname/your_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email":"j.smith@email.com",
7  "password":"123456",
8  "username":"j.smith@email.com"
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":"j.smith@email.com","password":"123456","username":"j.smith@email.com"}'

Ejemplo de respuesta a un webhook con atributos de usuario:

 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:

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 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}

3. 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.
4. El servidor de Xsolla Login genera un JWT de usuario.
5. El usuario es redirigido a la login_url con un parámetro de consulta token. El parámetro token contiene el JWT de usuario.

1. El cliente abre un formulario de autenticación para que el usuario pueda introducir su número de teléfono.
2. El usuario introduce su número de teléfono.
3. 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.
4. El cliente muestra un campo para que el usuario pueda rellenar el código de verificación.
5. El usuario introduce el código de verificación recibido.

6. 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.
7. 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.
8. 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:

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:

 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:

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 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}

1. El cliente abre un formulario de autenticación para que el usuario pueda introducir su número de teléfono.
2. El usuario introduce su número de teléfono.
3. 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.
4. El cliente muestra un campo para que el usuario pueda rellenar el código de verificación.
5. El usuario introduce el código de verificación recibido.

6. 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.
7. 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.
8. 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:

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:

 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:

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 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}

1. El cliente abre un formulario de autenticación para que el usuario pueda introducir su dirección de correo electrónico.
2. El usuario introduce su dirección de correo electrónico.
3. 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.
4. El cliente muestra un campo para que el usuario pueda rellenar el código de verificación.
5. El usuario introduce el código de verificación recibido.

6. 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
7. 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.
8. 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:

1POST https://your.hostname/your_email_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email": "user@mail.com",
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": "user@mail.com","type": "email"}'

Ejemplo de respuesta a un webhook con atributos de usuario:

 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:

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 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}

1. El cliente abre un formulario de autenticación para que el usuario pueda introducir su correo electrónico.
2. El usuario introduce su correo electrónico.
3. 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.
4. El cliente muestra un campo para que el usuario pueda rellenar el código de verificación.
5. El usuario introduce el código de verificación recibido.

6. 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.
7. 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.
8. 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:

1POST https://your.hostname/your_email_authentication_uri HTTP/1.1
2Authorization: Bearer {JWT}
3Content-Type: application/json
4
5{
6  "email": "user@mail.com",
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": "user@mail.com","type": "email"}'

Ejemplo de respuesta a un webhook con atributos de usuario:

 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:

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 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}

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:

1. 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.
2. El usuario inicia sesión en una red social.
3. 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.

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:

Ejemplo de carga útil de un token:

 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": "example@test.com",
 9  "username": "Smith707",
10  "provider": "google",
11  "id": "123",
12}

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

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:

 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:

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 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}

4. 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.

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:

1. 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.
2. El usuario inicia sesión en una red social.
3. 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.

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:

Ejemplo de carga útil de un token:

 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": "example@test.com",
 9  "username": "Smith707",
10  "provider": "google",
11  "id": "123",
12}

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

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:

 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:

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 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}

4. 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.