Track order status

• show the order status in the application UI
• credit a user’s balance after a successful payment
• grant the purchased items after a successful payment

Order tracking logic is included in the following SDK methods:

• Cart.Purchase — used to buy a cart
• Cart.PurchaseFreeCart — used to purchase free items via cart
• Catalog.Purchase — used to purchase items in one click
• Catalog.PurchaseForVirtualCurrency — used to purchase items for virtual currency
• Catalog.PurchaseFreeItem — used to purchase free items in one click

SDK reference documentation

Learn more about SDK methods and its parameters.

To handle a successful purchase, you only need to pass a function that is called when the order transitions to the done status in the onSuccess parameter.

Purchase methods encapsulate several methods for tracking the order status. The mechanism differs depending on the platform for which the application is built:

• For WebGL builds, tracking is based on the postMessage events of the payment interface widget. If the Pay Station widget sends a message that the order status changed to done or cancel, tracking stops.

• For builds for other platforms, tracking uses simple HTTP requests (short-polling) and WebSocket requests. Tracking is performed according to the following algorithm:

1. 1. A web socket connection is established.
   2. If the order status does not change to done or cancel within 5 minutes, the web socket connection is closed. If the order status changes to done or cancel, tracking stops.
   3. Order status tracking continues with short-polling. A simple HTTP order status request is sent once every 3 seconds. Tracking stops if:
      • order status changes to done or cancel
      • the order status does not done or cancel within 10 minutes

Useful links