Se você não tiver nenhum servidor ou implementar a lógica para processamento de compras no lado do cliente, você poderá usar as seguintes maneiras:

1. WebSocket API.
2. Short-polling.

Obtenção de status de pedido no lado do cliente usando WebSocket API

A solução utiliza websockets para obter diversos status do pedido sem obter informações detalhadas sobre ele. Esse método é preferível: apenas uma conexão é criada entre o cliente (por exemplo, seu site ou aplicativo móvel) e o servidor Xsolla, e portanto não há carga adicional no cliente ou no servidor.

Conclua as seguintes etapas:

1. Para permitir que o servidor de websocket Xsolla e o seu cliente identifiquem mensagens de status de pedido, crie uma conexão:

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 receber novas mensagens sobre status de pedidos, inscreva-se em eventos usando a função client.on:

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

3. Acione o estabelecimento de uma conexão:

client.connect()

4. Para receber o histórico de alterações nos status de pedidos, conecte o método API de histórico.

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
   });
});

Exemplo de corpo de mensagem:

{
order_id: 59614241,
status: 'new'
}

Os seguintes status de pedido são possíveis:

• New — o pedido foi criado mas não pago
• Paid — o pedido foi pago
• Done — o pedido foi entregue (todos os recibos enviados, entregas feitas do lado da Xsolla, plataformas externas, etc.)
• Canceled — o pedido é cancelado e o pagamento reembolsado a um usuário

Recomendações de uso de websocket:

• O tempo máximo de espera por uma resposta via websocket é de 5 minutos.
• A conexão deve ser estabelecida ao abrir a interface de pagamento.
• A conexão deve ser abortada quando o status final do pedido for recebido, seja ele Canceled ou Done.
• Se o tempo de vida útil do websocket expirar, ou se houver qualquer problema com a conexão, utilize short-polling.

  Short-polling

  Para obter informações detalhadas sobre itens no pedido depois de alternar para o status, chame a API Obter pedido.

  Observação

  Uma pesquisa periódica de status do pedido é usada — uma solicitação HTTP simples que recebe o status do pedido e informações sobre o pedido. O atraso recomendado entre as solicitações é de 3 segundos.

O método XsollaCatalog.Purchase encapsula diversos métodos para rastrear o status do pedido. O mecanismo de rastreamento é detalhado na documentação do SDK para Unity (PC, web).

Adicionalmente, você pode implementar o gerenciamento do status e conteúdo do pedido, que são passados à função de retorno de chamada onSuccess do método comprado.

Você pode rastrear o status do pedido usando o método SDK CheckPendingOrder. Passe os seguintes parâmetros ao método:

• AccessToken — o token de pagamento, que foi recebido ao comprar o item.
• OrderId o ID de pedido, que foi recebido ao comprar o item.
• SuccessCallback — o retorno de chamado de pagamento bem-sucedido.
• ErrorCallback — o retorno de chamada de erro de solicitação.
• bIsUserInvolvedToPayment — se o usuário está envolvido no processo de pagamento. Passe true para comprar com moedas reais, e false para a compra de itens grátis e compras com moedas virtuais.

O mecanismo de rastreamento é detalhado na documentação SDK de nível empresarial do Unreal Engine.

Para solicitar o status e conteúdo de um pedido, chame o método SDK CheckOrder, passe os seguintes parâmetros a ele:

• AccessToken — o token de pagamento, que foi recebido ao comprar o item.
• OrderId o ID de pedido, que foi recebido ao comprar o item.
• SuccessCallback — o retorno de chamada de verificação de pedido bem-sucedido. A resposta contém o status de pedido.
• ErrorCallback — o retorno de chamada de erro de solicitação.