Si no dispone de servidor o implementa la lógica para el procesamiento de compras en el lado del cliente, puede utilizar los siguientes métodos:

1. WebSocket API.
2. Short-polling (Sondeo corto).

3. API de eventos de Xsolla.

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:

 1const client = new Centrifuge(
 2connectionURL,
 3{
 4data: {
 5  user_external_id: user_external_id,
 6  auth: auth,
 7  project_id: project_id
 8}
 9}
10)
11connectionURL - wss://ws-store.xsolla.com/connection/websocket
12auth - user JWT token

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

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

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

1client.connect()

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

 1client.on('subscribed', function (ctx) {
 2   client.history(ctx.channel, { limit: -1, since: { offset: 0 }, reverse: false }).then(function (resp) {
 3resp.publications.forEach((ctx) => {
 4   /handle the status
 5});
 6
 7   }, function (err) {
 8       //handle the status
 9   });
10});

Ejemplo de cuerpo de mensaje:

1{
2order_id: 59614241,
3status: 'new'
4}

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

Recomendaciones de uso de Websocket:

• El tiempo de espera máximo de una respuesta mediante websocket es de 5 minutos.
• La conexión debería establecerse al abrir la interfaz de pago.
• La conexión debería interrumpirse cuando se reciba el estado final del pedido, ya sea Canceled o Done.
• Si se agota la vida útil del websocket o si hay cualquier problema con la conexión, recurra al 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 Obtener pedido.

API de eventos de Xsolla

Descripción general

La API de eventos de Xsolla le permite utilizar el servicio GetUpdates para recibir y gestionar los datos de pago directamente desde el cliente de su aplicación sin tener que utilizar webhooks en su servidor. Utilice esta opción de integración para simplificar la integración y evitar tener que configurar su propio servidor para procesar webhooks de pago.

Interacción entre su juego y Xsolla:

Cómo establecerlo

Para recibir eventos de Xsolla mediante API:

1. En su proyecto en Cuenta del editor, vaya a Project settings > Webhooks.
2. Haga clic en Use API. La configuración se guarda de forma automática.

3. Desde el cliente de la aplicación, envíe una solicitud a https://getupdate.xsolla.com/events para obtener información sobre el pago. Consulte las referencias de API para obtener más información. En la respuesta, recibirá los datos de pago en el mismo formato que el webhook Pago.
4. Si el pago se realiza correctamente, conceda la compra al usuario.

Referencia de la API

Obtener lista de eventos no procesados para el usuario

1GET https://getupdate.xsolla.com/events

Seguridad: Token JWT de usuario con Bearer

Ejemplo de respuesta:

 1{
 2  "events": [
 3   {
 4     "id": 49, // event_id
 5     "status": 0,
 6     "created_at": "2025-04-03T21:21:27Z",
 7     "data": {
 8       "notification_type": "payment",
 9       "purchase": {
10         "order": {
11           "id": 000000001,
12           "lineitems": [
13             {
14               "quantity": 1,
15               "sku": "skill"
16             }
17           ]
18         }
19       },
20       ...
21     }
22   }
23 ]
24}

Marcar un evento como procesado

1POST https://getupdate.xsolla.com/events/<event_id>/processed

event_id es el parámetro events.id que se obtiene de la respuesta a la llamada a la API Obtener lista de eventos no procesados para el usuario.

Seguridad: Token JWT de usuario con Bearer

El método XsollaCatalog.Purchase encapsula varios métodos de seguimiento del estado del pedido. El mecanismo de seguimiento se explica en la documentación del SDK para Unity (PC, web).

Además, puede implementar el procesamiento del estado y del contenido de un pedido, que se transmiten a la función de devolución de llamada onSuccess del método de compra.

Puede hacer el seguimiento del estado del pedido usando el método AuthViaSocialNetwork del SDK. Transmita los siguientes parámetros al método:

• AccessToken: el token de pago, el cual se recibió al adquirir el artículo.
• OrderId: el ID del pedido, el cual se recibió al adquirir el artículo.
• SuccessCallback: devolución de llamada de pago realizada correctamente.
• ErrorCallback: devolución de llamada de error de la solicitud.
• bIsUserInvolvedToPayment: si el usuario participa en el proceso de pago. Transmita true para la compra con moneda real, y false para la compra de artículos gratuitos y la compra con moneda virtual.

El mecanismo de seguimiento se explica en la documentación de SDK de nivel empresarial para Unreal Engine.

Para solicitar el estado y el contenido de un pedido, invoque el método CheckOrder del SDK, transmitiéndole los siguientes parámetros:

• AccessToken: el token de pago, el cual se recibió al adquirir el artículo.
• OrderId: el ID del pedido, el cual se recibió al adquirir el artículo.
• SuccessCallback: la devolución de llamada para la comprobación satisfactoria del pedido. La respuesta contiene el estado del pedido.
• ErrorCallback: devolución de llamada de error de la solicitud.