Suivi de l’état de la commande

Une fois que l’utilisateur a réalisé un achat, votre application peut effectuer les actions suivantes :

• 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.

Pour suivre l’état de la commande lorsque vous utilisez le SDK pour implémenter la logique de ces actions, vous pouvez :

• vous abonner aux changements d’état de la commande (recommandé) ;
• demander le statut de la commande.

S'abonner aux changements d'état des commandes

Utiliser la méthode de la bibliothèque Store

Pour vous abonner aux changements d’état des commandes, utilisez la méthode SDK getOrderStatus de la bibliothèque Store et passez-lui les paramètres suivants :

• listener — objet écouteur de type OrderStatusListener ;
• orderId — ID de la commande reçu en tant que paramètre lors de l’achat via le panier, de l’achat en un clic ou de l’achat contre de la monnaie virtuelle.

Documentation de référence du SDK

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

Exemple d’appel à la méthode XStore.getOrderStatus :

XStore.getOrderStatus(object : OrderStatusListener() {

               override fun  onStatusUpdate(status: OrderResponse.Status) {

                   if(status == OrderResponse.Status.DONE) {

                       Log.d("MainActivity", "Success")

                   }

               }

               override fun  onFailure() {

                   Log.d("MainActivity", "Failure")

               }

           }, orderId)

Nous recommandons d’appeler la méthode XStore.getOrderStatus lors de l’ouverture de l’interface de paiement.

Les méthodes d’achat encapsulent plusieurs méthodes de suivi de l’état de la commande. Le suivi est effectué selon l’algorithme suivant :

1. Une connexion WebSocket est établie.
2. Si la connexion WebSocket est établie avec succès et que le statut de la commande passe à done ou à cancel, le suivi s'arrête. Si la connexion WebSocket échoue ou si la réponse contient des données incorrectes, l'état de la commande est suivi à l'aide de short-polling.
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.

Utiliser la méthode de la bibliothèque Payments

1. Lors de la création de l’objet XPayments.IntentBuilder, passez la fonction de rappel StatusReceivedCallback à l’aide de la méthode setStatusReceivedCallback.
2. Implémentez la méthode onSuccess dans la fonction de rappel StatusReceivedCallback, qui est appelé à chaque changement d’état unique.

Exemple :

val intent = XPayments.createIntentBuilder(this)
               .accessToken(<accessToken>)
               .isSandbox(<isSandbox>)
           	.setStatusReceivedCallback(object : StatusReceivedCallback {
               	override fun onSuccess(data: InvoicesDataResponse) {
                   		Log.d(TAG, "StatusReceivedCallback is fired. Result data = $data")
               	}
           	})
           	.build()

Demander l'état de la commande

Pour demander le statut actuel du paiement, appelez la méthode getOrder de la bibliothèque Store ; passez les paramètres suivants :

• orderId — ID de la commande reçu lors de l’achat via le panier, l’achat en un clic ou l’achat contre de la monnaie virtuelle.
• callback — fonction de rappel permettant de récupérer avec succès les informations sur la commande. Lors de l’implémentation d’une fonction de rappel, utilisez l’interface GetStatusCallback et implémentez les méthodes onSuccess et onError.

Exemple :

XPayments.getStatus(<token>, <isSandbox>, object : GetStatusCallback {
            override fun onSuccess(data: InvoicesDataResponse?) {
                Log.d(TAG, "onSuccess is fired. Result data = $data")
            }

           override fun onError(throwable: Throwable?, errorMessage: String?) {
                Log.d(TAG, "onError is fired. ErrorMessage = $errorMessage")
            }

})

Liens utiles