Suivi de l’état de la commande

• afficher le statut de la commande dans l’interface de l’application ;
• créditer le solde de l’utilisateur après un paiement réussi ;
• octroyer les objets achetés après un paiement réussi.

La logique de suivi des commandes est incluse dans les méthodes SDK suivantes :

• Cart.Purchase — utilisée pour acheter le panier ;
• Cart.PurchaseFreeCart — utilisée pour acheter des biens gratuits via le panier ;
• Catalog.Purchase — utilisée pour acheter des objets en un clic ;
• Catalog.PurchaseForVirtualCurrency — utilisée pour acheter des objets contre de la monnaie virtuelle ;
• Catalog.PurchaseFreeItem — utilisée pour acheter des biens gratuits en un clic.

Documentation de référence du SDK

En savoir plus sur les méthodes SDK et leurs paramètres.

Pour gérer un achat réussi, il vous suffit de passer dans le paramètre onSuccess la fonction qui est appelée lorsque le statut de la commande passe à done.

Les méthodes d’achat encapsulent plusieurs méthodes de suivi de l’état de la commande. Le mécanisme varie en fonction de la plateforme pour laquelle l’application est créée :

• Pour les builds WebGL, le suivi repose sur les événements postMessage émis par le widget de l'interface de paiement. Lorsque le widget Pay Station envoie un message indiquant que le statut de la commande est passé à done ou cancel, le suivi s'arrête.

• Pour les builds destinés à d'autres plateformes, le suivi utilise de simples requêtes HTTP (short polling) et des requêtes WebSocket. Le suivi est effectué selon l'algorithme suivant :

1. 1. Une connexion WebSocket est établie.
   2. Si le statut de la commande ne passe pas à done ou cancel dans les 5 minutes, la connexion WebSocket est fermée. Si le statut de la commande passe à done ou cancel, le suivi s'arrête.
   3. Le suivi de l'état de la commande se poursuit à l'aide de short polling. Une simple requête HTTP d'état de commande est envoyée toutes les 3 secondes. Le suivi s'arrête si :
      • le statut de la commande passe à done ou cancel ;
      • le statut de la commande ne passe pas à done ou cancel dans les 10 minutes.

Liens utiles