Vérification du statut d'une transaction

Une requête de statut de transaction permet d'obtenir le résultat d'une transaction précédente. Son usage principal est la récupération : si votre application a perdu la connexion ou a redémarré en cours de paiement sans jamais voir la réponse, une requête de statut vous indique ce qui s'est réellement passé afin d'éviter une double facturation ou de laisser une vente en suspens.

Prérequis : une session active.

L'appel

viewModelScope.launch {
    clientSDK.sendTransactionStatusRequest(
        RetailerMessageArguments.StatusRequestMessageArguments(
            MessageReference(messageCategory = "Payment")
        )
    )
}

• MessageReference — identifie quel message/transaction vérifier. Le messageCategory sélectionne le type d'opération (par exemple un paiement). Consultez la référence API pour voir l'ensemble des champs MessageReference si vous devez cibler un message spécifique plutôt que le dernier.

Par défaut, cela récupère le statut de la dernière transaction terminée dans la catégorie référencée.

Lecture du résultat

when (message) {
    is SuccessRetailerTransactionStatusResponse -> { /* lire le résultat récupéré */ }
    is ErrorRetailerTransactionStatusResponse   -> { /* pas de transaction correspondante / échec */ }
    is RetailerDisplayRequest                   -> { /* progression, le cas échéant */ }
}

Une réponse de statut réussie contient le résultat de la transaction originale, y compris son POITransactionID — ce qui fait d'une requête de statut un moyen de récupérer un ID de transaction POI dont vous avez besoin pour un remboursement mais que vous n'avez pas stocké. Voir Guide : annuler une transaction.

Quand l'utiliser

• Après une perte de connexion pendant un paiement — confirmer si le paiement a été effectué avant de réessayer.
• Après que votre application a redémarré en cours de transaction — récupérer le résultat manqué.
• Pour récupérer un POITransactionID en vue d'un remboursement lorsque vous ne l'avez pas capturé au moment du paiement.

Pour les paiements courants où vous avez reçu la réponse normalement, une requête de statut n'est pas nécessaire — vous avez déjà le résultat.

Articles connexes

• Guide : effectuer un paiement — la transaction dont vous vérifiez le statut.
• Guide : annuler une transaction — utilise le POITransactionID qu'une requête de statut peut récupérer.
• Cycle de vie de la session et de la connexion — les scénarios de perte de connexion qui rendent les vérifications de statut nécessaires.
• Référence API (sdk-doc.zip) — champs complets de MessageReference.