In-Game Store / Establecer la venta de artículos

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

ProductosMé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 cestaTransmita 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 Catalog del grupo de métodos Virtual items & currency (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:

Nota
Los datos del usuario incluyen el saldo en moneda real (cambio), las tarjetas guardadas, el historial de transacciones y las suscripciones.

Autenticación mediante token de acceso a Pay Station

Nota
Recomendado si desea integrar los métodos de In-Game Store y de Buy Button.
El flujo de interacción entre su cliente y el servidor de Xsolla:
  1. Su cliente envía una solicitud de autenticación a su servidor.
  2. Su servidor solicita un token de autorización y envía un encabezado que contiene los parámetros project_id/merchant_id y api_key al servidor de Xsolla.
  3. El servidor de Xsolla devuelve el token de acceso a Pay Station.
  4. Su servidor transmite el token de acceso a Pay Station a su cliente.
  5. 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 Buy Button 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
Aviso

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ámetroTipoDescripción
settings
objectConfiguración personalizada del proyecto (objeto).
settings.project_id
integerID del juego en Xsolla. Se puede encontrar en Cuenta del editor junto al nombre de su proyecto. Obligatorio.
user
objectDatos del usuario (objeto).
user.id
objectID del usuario en su sistema de autorización (objeto).
user.id.value
stringID del usuario. Obligatorio.
user.email
objectDirección de correo electrónico (objeto).
user.email.value
stringCorreo electrónico del usuario. Debe ser válido conforme al protocolo RFC 822. Obligatorio.
user.name
objectNombre de pantalla del usuario (objeto).Obligatorio.
user.name.value
stringNombre de pantalla del usuario
user.steam_id
objectID de usuario de Steam (objeto)
user.steam_id.value
stringID de usuario de Steam. Obligatorio si la aplicación se publica en Steam.
user.playfab_id
objectID de usuario de PlayFab (objeto)
user.playfab_id.value
stringID de usuario de PlayFab. Obligatorio si la aplicación utiliza los servicios de PlayFab para conceder artículos.
Vea ejemplos de solicitudes y respuestas en la Referencia de la API .
Aviso
En la solicitud, utilice únicamente los parámetros de la lista anterior. No transmita otros parámetros de la llamada API (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.

Tu progreso
¡Gracias por tu mensaje!
Última actualización: 5 de Abril de 2024

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

Informar de un problema
Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
Déjanos tu correo electrónico para que te podamos responder
¡Gracias por tu mensaje!