Integrar la tienda en el juego

Cuando haya creado y configurado los productos (objetos virtuales, monedas virtuales, lotes y claves) en su Cuenta del editor, añada una In-Game Store a su juego:

1. Implemente la visualización del catálogo de artículos.
2. Implemente la lógica de venta de artículos.

Visualización del catálogo de artículos

Implementar una visualización del catálogo de artículos a través de las llamadas In-Game Store API:

Vender artículos

Puede vender artículos de las siguientes formas:

1. Compra rápida de un artículo. En este caso, puede vender un código de artículo (SKU) en cualquier cantidad. (por ejemplo, 100 pociones idénticas o una cantidad personalizada de moneda virtual).
2. Compra de una cesta. En este caso, el jugador puede prellenar una cesta y luego añadir o quitar artículos, o cambiar sus cantidades.

Compra rápida

Compra con cesta

1. Para establecer una cesta y obtener el token:
   • En el cliente - si desea implementar la cesta en su aplicación por su cuenta.
   • En el servidor - si desea utilizar la solución de Xsolla (llamadas In-Game Store API) para gestionar la cesta.
2. Para abrir la interfaz de pago.

Establecer y comprar una cesta en el cliente

Implemente por sus medios la lógica de añadir y eliminar artículos. También debe tener en cuenta que antes de hace una llamada API para configurar una cesta, no tendrá información sobre qué promociones se aplicarán a la compra. Esto significa que no se conocerá el coste total ni los detalles de los artículos de bonificación añadidos.

1. Después de que el jugador haya llenado una cesta, invoque la API Fill cart with items. La información actual sobre los artículos seleccionados (precios antes y después de descuentos, artículos de bonificación) se transmitirá a la respuesta.
2. Llame a la API Create order with all items from current cart. El ID del pedido y el token de pago se transmitirán a la respuesta. El pedido creado recibirá el estado de pedido New.
3. Abra la interfaz de pago.

Establecer y comprar una cesta en el servidor

Esta variante puede tardar más en configurar la cesta, ya que cada cambio en la cesta debe ir acompañado de llamadas API.

Realice los siguientes pasos:

1. Modifique la cesta:
   • Para añadir un artículo o modificar la cantidad de artículos, llame a la API Update cart item by card ID.
   • Para eliminar un artículo, llame a la API Delete cart item by card ID.

2. Llame a la API Create order with all items from the current cart. El ID del pedido y el token de pago se transmitirán a la respuesta. El pedido creado recibirá un estado de pedido New.
3. Abra la interfaz de pago.

Abrir la interfaz de pago

Para pagar artículos, abra la interfaz de pago. Se transmitirá un token para abrir la interfaz de pago a la respuesta API Create order with all items from current cart.

Implemente la apertura de la interfaz de pago de una de las siguientes formas:

• En una ventana nueva. Para abrir la interfaz de pago en una nueva ventana del navegador, utilice el enlace: https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN, en el cual ACCESS_TOKEN es el token recibido al crear el pedido.
• A través de widget. Utilice el script Xsolla PayStation Widget (el archivo README contiene las instrucciones).

Probar el proceso de pago

Puede probar el flujo de pagos en el modo Aislador de proceso (Sandbox). Puede utilizar una tarjeta bancaria de prueba y cualquier cuenta.

Obtener el estado del pedido del usuario

Puede utilizar las siguientes formas para obtener el estado del pedido de un usuario:

1. En el lado del servidor mediante webhooks.
2. En el lado del cliente mediante WebSocket API o IGS API.

Obtener el estado del pedido del usuario en el lado del servidor mediante webhooks

Obtener el estado del pedido del usuario en el lado del cliente a través de WebSocket API o IGS API

1. WebSocket API.
2. Short-polling.

Obtener el estado de un pedido en el lado del cliente usando la API de WebSocket

La solución usa websockets para obtener los estados del pedido sin recuperar información detallada sobre este. Este método es preferente: solo se crea una conexión entre el cliente (por ejemplo, su sitio web o aplicación móvil) y el servidor de Xsolla, por lo que no hay carga adicional ni en el cliente ni en el servidor.

Dé los siguientes pasos:

1. Para permitir que el servidor de Websocket de Xsolla y su cliente identifiquen los mensajes de estado del pedido, cree una conexión:

const client = new Centrifuge(
connectionURL,
{
data: {
  user_external_id: user_external_id,
  auth: auth,
  project_id: project_id
}
}
)
connectionURL - wss://ws-store.xsolla.com/connection/websocket
auth - user JWT token

2. Para recibir nuevos mensajes sobre el estado del pedido, suscríbase a los eventos mediante la función client.on:

client.on('publication', (ctx) => {
   //handle the status
});

3. Desencadenar el establecimiento de una conexión real:

client.connect()

4. Para recibir el historial de cambios en los estados del pedido, conecte el método del historial de la API.

client.on('subscribed', function (ctx) {
   client.history(ctx.channel, { limit: -1, since: { offset: 0 }, reverse: false }).then(function (resp) {
resp.publications.forEach((ctx) => {
   /handle the status
});

   }, function (err) {
       //handle the status
   });
});

Ejemplo de cuerpo de mensaje:

{
order_id: 59614241,
status: 'new'
}

Están disponibles los siguientes estados de pedido:

• New — pedido creado pero no pagado
• Paid — pedido pagado
• Done — pedido entregado (todos los recibos enviados, entregas realizadas por parte de Xsolla, plataformas externas, etc.)
• Canceled — pedido cancelado y pago reembolsado a un usuario

El tiempo necesario para una respuesta vía Websocket es de 5 minutos. Después de ese tiempo o si hay algún problema con el Websocket, se recomienda utilizar el sondeo corto.

Sondeo corto

Para obtener información detallada sobre los artículos del pedido después de cambiar el estado, llame a la API Get order.