Acompanhamento do status do pedido

• mostrar o status do pedido na interface do aplicativo
• creditar o saldo de um usuário após um pagamento bem-sucedido
• conceder os itens comprados após um pagamento bem-sucedido

A lógica de rastreamento de pedidos está incluída nos seguintes métodos SDK:

• Cart.Purchase — usado para comprar um carrinho
• Cart.PurchaseFreeCart — usado para comprar itens gratuitos através do carrinho
• Catalog.Purchase — usado para comprar itens em um clique
• Catalog.PurchaseForVirtualCurrency — usado para comprar itens com moedas virtuais
• Catalog.PurchaseFreeItem — usado para comprar itens gratuitos em um clique

Documentação de referência do SDK

Saiba mais sobre os métodos SDK e seus parâmetros.

Para lidar com uma compra bem-sucedida, você só precisa passar uma função que é chamada quando o pedido transita para o status done no parâmetro onSuccess.

Os métodos de compra encapsulam vários métodos para rastrear o status do pedido. O mecanismo difere dependendo da plataforma para a qual o aplicativo foi desenvolvido:

• Para compilações WebGL, o rastreamento é baseado nos eventos postMessage do widget de interface de pagamento. Se o widget Pay Station enviar uma mensagem informando que o status do pedido foi alterado para done ou cancel, o rastreamento é interrompido.

• Para compilações de outras plataformas, o rastreamento usa solicitações HTTP simples (short-polling) e solicitações WebSocket. O rastreamento é realizado de acordo com o seguinte algoritmo:

1. 1. Uma conexão de WebSocket é estabelecida.
   2. Se o status do pedido não for alterado para done ou cancel dentro de 5 minutos, a conexão WebSocket será fechada. Se o status do pedido for alterado para done ou cancel, o rastreamento é interrompido.
   3. O rastreamento do status do pedido continuará com short-polling. Uma simples solicitação de status de pedido HTTP é enviada uma vez a cada 3 segundos. O rastreamento é interrompido se:
      • o status do pedido for alterado para done ou cancel
      • o status do pedido não for alterado para done ou cancel dentro de 10 minutos

Links úteis