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

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

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.

  Nota

  Se utiliza un sondeo periódico del estado del pedido: una simple solicitud HTTP que recibe el estado del pedido e información sobre el mismo. El retardo recomendado entre solicitudes es de 3 segundos.

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.