Integre a loja ao jogo

Depois de criar e configurar bens (itens virtuais, moedas virtuais, conjuntos, chaves) em sua Conta de Distribuidor, adicione uma In-Game Store ao seu jogo:

1. Implemente a exibição do catálogo de itens.
2. Implemente a lógica de venda de itens.

Exibição do catálogo de itens

Implemente uma exibição do catálogo de itens por meio de chamadas da In-Game Store & Buy Button API:

Venda de itens

Você pode vender itens das seguintes maneiras:

1. Compra rápida de um item. Neste caso, você pode vender um SKU em qualquer quantidade (por exemplo, 100 poções idênticas ou uma quantia personalizada de moedas virtuais).
2. Comprar um carrinho. Neste caso, o jogador pode pré-encher um carrinho, adicionar ou remover itens, ou alterar suas quantidades.

Compra rápida

Compra no carrinho

1. Para configurar um carrinho e obter o token:
   • No cliente — se você quiser implementar o carrinho em seu aplicativo por conta própria.
   • No servidor — se você quiser usar a solução da Xsolla (Chamadas de API In-Game Store & Buy Button) para gerenciar o carrinho.
2. Para abrir a interface de pagamento.

Configure e compre um carrinho no cliente

Implemente a lógica de adicionar e remover itens por si mesmo. Você também precisa considerar que, antes de chamar a API para configurar um carrinho, você não terá informações sobre quais promoções serão aplicadas à compra. Isso significa que o custo total e os detalhes dos itens de bônus adicionados não serão conhecidos.

1. Depois que o jogador tiver preenchido um carrinho, chame a API Fill cart with items. As informações atuais sobre os itens selecionados (preços antes e depois dos descontos, itens bônus) serão passadas para a resposta.
2. Chame a API Create order with all items from current cart. O ID do pedido e o token de pagamento serão passados para a resposta. O pedido criado receberá um status de pedido New.
3. Abra a interface de pagamento.

Configure e compre um carrinho no servidor

Essa variante pode levar mais tempo para configurar o carrinho, já que cada alteração no carrinho deve ser acompanhada por chamadas de API.

Conclua as seguintes etapas:

1. Alterar o carrinho:
   • Para adicionar um item ou alterar a quantidade do item, chame a API Update cart item by card ID.
   • Para remover um item, chame a API Delete cart item by card ID.

2. Chame a API Create order with all items from the current cart. O ID do pedido e o token de pagamento serão passados para a resposta. O pedido criado receberá um status de New.
3. Abra a interface de pagamento.

Abertura da interface de pagamento

Para itens pagos, abra a interface de pagamento. Um token para abrir a interface de pagamento será passado para a resposta API Create order with all items from current cart.

Implemente a abertura da interface de pagamento de uma das seguintes maneiras:

• Em uma nova janela. Para abrir a interface de pagamento em uma nova janela do navegador, use o link: https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN, onde ACCESS_TOKEN é o token recebido quando o pedido foi criado.
• Via widget. Use o script Xsolla PayStation Widget (o arquivo README contém instruções).

Teste do processo de pagamento

Você pode testar o fluxo de pagamento no modo Sandbox. Você pode usar um cartão bancário de teste e qualquer conta.

Obtenção do status do pedido do usuário

Você pode usar as seguintes maneiras de obter um status de pedido do usuário:

1. No lado do servidor via webhooks.
2. No lado do cliente via WebSocket API ou IGS&BB API.

Obtenha o status do pedido do usuário no lado do servidor por meio de webhooks

Obtenha o status do pedido do usuário no lado do cliente via WebSocket API ou IGS&BB API

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

O tempo necessário para uma resposta via websocket é de 5 minutos. Depois disso ou se houver algum problema com o websocket, recomenda-se usar short-polling.

Short-polling