Establecer la venta de artículos
In-Game Store le permite monetizar los juegos mediante la venta en el juego de los siguientes artículos con moneda real o virtual:
- moneda interna del juego y paquetes de monedas
- artículos consumibles
- artículos no consumibles
- artículos de duración limitada
| Productos | Método de venta |
|---|---|
| Un artículo (p. ej., un artículo virtual o una cantidad personalizada de moneda virtual) | Llamadas de compra rápida |
| Varios artículos en una cesta | Transmita el ID único de usuario. El ID único de usuario se utiliza en el título como número o línea al llamar a los métodos API de la subsección Catálogo del grupo de métodos Artículos virtuales y moneda (parámetro x-unauthorized-id). El identificador se genera en el front-end, por ejemplo, mediante la biblioteca de generación de identificadores. |
Para gestionar el acceso de los usuarios a su aplicación y a las funciones de los productos de Xsolla, establezca un sistema de autenticación. Para ello, puede utilizar Xsolla Login o implementar su propio sistema de autenticación.
Si ha implementado su propio sistema de autenticación y sólo necesita la interfaz de pago, genere un token de acceso a Pay Station y establezca webhooks en su servidor.
Puedes usar Xsolla Login para su tienda en el juego, si no tiene sus propios servidores o quiere usar la solución existente. Las siguientes funciones se realizan en el lado de Xsolla:
- almacenar y gestionar un catálogo
- gestionar precios
- almacenar datos sobre precios regionales
- autenticar usuarios
- procesar transacciones
Autenticación mediante Xsolla Login
Xsolla Login admite el protocolo estándar OAuth 2.0 para el registro y autenticación de usuarios. El protocolo estándar OAuth 2.0 ayuda a simplificar el desarrollo de la aplicación en el lado del cliente. OAuth 2.0 permite actualizar el token de acceso sin involucrar al usuario.
Los datos de los usuarios autorizados pueden almacenarse:
- En el almacenamiento de Xsolla. Consulte Introducción a Xsolla Login para establecerlo.
- En la base de datos de PlayFab. Utilice las instrucciones para el almacenamiento de PlayFab para establecerlo.
- En un almacenamiento personalizado. Utilice las instrucciones para configurar el almacenamiento personalizado.
Autenticación mediante token de acceso a Pay Station
Flujo general
El flujo de interacción entre su cliente y el servidor de Xsolla:- Su cliente envía una solicitud de autenticación a su servidor.
- Su servidor solicita un token de autorización y envía un encabezado que contiene los parámetros
project_id/merchant_idyapi_keyal servidor de Xsolla. - El servidor de Xsolla devuelve el token de acceso a Pay Station.
- Su servidor transmite el token de acceso a Pay Station a su cliente.
- El token de acceso de Pay Station devuelto se usa como token de autorización para la autenticación en la API de In-Game Store y el desarrollo de una interfaz de tienda.
Obtener un token de acceso a Pay Station
En el back-end de su aplicación, implemente un método para obtener un código de acceso a Pay Station mediante una solicitud HTTP POST.
La API de Xsolla usa la autenticación HTTP básica. La solicitud debe contener el encabezado Authorization: Basic <your_authorization_basic_key>, en el cual <your_authorization_basic_key> es el par ID de vendedor:clave de API, codificado según el estándar Base64. Vaya a Cuenta del editor para localizar estos parámetros:
- Merchant ID se muestra:
- en la sección Company settings > Company.
- En la URL de la barra de direcciones del navegador de cualquier página de Cuenta del editor. La URL tiene el siguiente formato:
https://publisher.xsolla.com/<merchant ID>/<Publisher Account section>.
- Clave de API se muestra en la Cuenta del editor solo una vez cuando se crea y debe almacenarse en su servidor. Puede crear una nueva clave en la siguiente sección:
- Company settings > API keys
- Project settings > API keys
Para obtener más información sobre cómo trabajar con claves API, consulte la Referencia de la API.
Recomendaciones clave:
- Guarde la clave de API generada en su servidor. Puede ver la clave de API en la Cuenta del editor solo una vez cuando se crea.
- Mantenga su clave de API en secreto. Proporciona acceso a su cuenta personal y a sus proyectos en Cuenta del editor.
- La clave de API debe almacenarse en su servidor y nunca en archivos binarios o en el front-end.
Si una llamada API que necesita no contiene el parámetro de ruta project_id, use la clave de API que sea válida en todos los proyectos de la empresa para establecer la autorización.
Solicitud HTTP:
POST https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token
Para obtener el token, transmita los siguientes parámetros en el cuerpo de la solicitud:
| Parámetro | Tipo | Descripción |
|---|---|---|
settings | object | Configuración personalizada del proyecto (objeto). |
settings.project_id | integer | ID del juego en Xsolla. Se puede encontrar en Cuenta del editor junto al nombre de su proyecto. Obligatorio. |
user | object | Datos del usuario (objeto). |
user.id | object | ID del usuario en su sistema de autorización (objeto). |
user.id.value | string | ID del usuario. Obligatorio. |
user.email | object | Dirección de correo electrónico (objeto). |
user.email.value | string | Correo electrónico del usuario. Debe ser válido conforme al protocolo RFC 822. Obligatorio. |
user.name | object | Nombre de pantalla del usuario (objeto).Obligatorio. |
user.name.value | string | Nombre de pantalla del usuario |
user.steam_id | object | ID de usuario de Steam (objeto) |
user.steam_id.value | string | ID de usuario de Steam. Obligatorio si la aplicación se publica en Steam. |
user.playfab_id | object | ID de usuario de PlayFab (objeto) |
user.playfab_id.value | string | ID de usuario de PlayFab. Obligatorio si la aplicación utiliza los servicios de PlayFab para conceder artículos. |
custom_parameters, purchase, etc.), no están pensados para recibir un token de autorización.El ciclo de vida del código de acceso a Pay Station cuando se trabaja con la tienda en el juego y con el inventario es de 1 hora después de la última llamada a la API de Xsolla. Para cambiar el ciclo de vida del token de acceso a Pay Station, contacte con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com.
Implemente la lógica de recepción de un nuevo token de acceso a Pay Station después de su expiración. Se recomienda obtener un nuevo token en modo de segundo plano, para que el usuario no tenga que volver a iniciar sesión en la aplicación.
¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.
