agricole
S'inscrire

Retour sur la transaction

Le traitement des transactions via notre API CAWL ecommerce implique :

Par conséquent, une transaction passe par différents stades et statuts. La mise à jour de votre base de données de transactions en conséquence est essentielle pour vos opérations commerciales, vous devez donc avoir la possibilité d’en demander le statut à tout moment.

CAWL ecommerce propose différents moyens de le faire, couvrant de multiples cas d’utilisation.

Aperçu

Pour toutes les étapes du cycle de vie d’une transaction, l’API CAWL ecommerce met à disposition différents moyens de suivre le statut d’une transaction.

Lors de la création du paiement initial via les requêtes CreateHostedCheckout/CreatePayment, vous recevez une réponse instantanée de notre plateforme. Cependant, aucun de ces endpoints n’est adapté pour obtenir le statut de la transaction ultérieurement.

Pour obtenir le statut de la transaction à tout moment par la suite, vous pouvez :

Nous allons examiner chaque option et les cas d’usage associés.

Reportez-vous à la matrice de décision pour une vue d’ensemble des différentes méthodes et de leurs cas d’usage.

Consultez notre page dédiée Statuts pour une vue complète de tous les statuts, de leur signification et des actions de suivi possibles.

Merchant Portal

Le Merchant Portal est une interface conviviale permettant de vérifier manuellement le statut d'une transaction. Dans l'onglet « Transactions », vous pouvez rechercher, filtrer et afficher le statut de chaque paiement, son montant ainsi que les informations client. Ce flux manuel offre une visibilité immédiate sans nécessiter d'intégration technique, ce qui le rend idéal pour les demandes ponctuelles et le suivi de base par du personnel non technique.

Consultez le chapitre dédié dans notre guide Merchant Portal pour en savoir plus.

Endpoints de l'API CAWL ecommerce

L'API CAWL ecommerce propose des endpoints dédiés pour le suivi des transactions, permettant une surveillance automatisée et une intégration dans l'infrastructure de votre boutique en ligne :

  • GetHostedCheckout permet d'obtenir des mises à jour de statut pour la Hosted Checkout Page. Contrairement à GetPayment/GetPaymentDetails, il accepte un hostedCheckoutId (et non un payment.id, qui peut avoir un format différent) pour remonter l'activité du client et le résultat de la transaction. Vous pouvez surveiller le checkout en temps réel au fur et à mesure du processus. Le hostedCheckoutId expire après trois heures. Pour assurer le suivi des transactions au-delà de cette période, utilisez plutôt GetPayment ou GetPaymentDetails.
  • GetPayment vous permet d'assurer le suivi d'une transaction, quel que soit le mode d'intégration initial. Il accepte uniquement le payment.id d'origine issu de la requête CreatePayment/CreateHostedCheckout initiale. GetPayment renvoie le statut global de la transaction, ce qui est utile pour des vérifications rapides de statut.
  • GetPaymentDetails vous permet également d'assurer le suivi d'une transaction, quel que soit le mode d'intégration initial. Contrairement à GetPayment, GetPaymentDetails accepte tout payment.id, qu'il provienne de la requête CreatePayment/CreateHostedCheckout initiale ou d'opérations de maintenance ultérieures.
    GetPaymentDetails fournit un historique complet des opérations de maintenance effectuées sur la transaction. Cela en fait l'outil idéal pour les analyses détaillées nécessitant l'historique complet de la transaction.

Utilisez les exemples de code suivants pour envoyer des requêtes à ces endpoints d'API :

GetHostedCheckout

GetPayment

GetPaymentDetails

Webhooks

Les webhooks sont des notifications qui envoient automatiquement des informations de transaction vers votre système au fur et à mesure que les événements se produisent. Ces messages proviennent de notre plateforme et sont envoyés vers votre serveur, fournissant des mises à jour sur l'activité des transactions. Les webhooks couvrent à la fois les nouvelles transactions, les opérations de maintenance et le suivi des changements de statut.

Notez que les webhooks sont asynchrones et ne sont pas adaptés à la mise à jour en temps réel de votre base de données des statuts de transaction. Si vous avez besoin de mises à jour en temps réel pour adapter le parcours de paiement du client, nous vous recommandons d'utiliser les requêtes API.
Consultez notre guide dédié aux webhooks pour une vue d'ensemble complète.

Matrice de décision

Chacune des méthodes diffère en termes de :

  • Exigences d'intégration.
  • Données d'entrée/sortie.
  • Cas d'usage applicables.

Reportez-vous à ce tableau pour sélectionner l'option la plus adaptée à vos besoins métier.

Merchant Portal GetHostedCheckout GetPayment GetPaymentDetails Webhooks
Intégration technique Accès via navigateur web, sans code Requête GET serveur-à-serveur Requête GET serveur-à-serveur Requête GET serveur-à-serveur Notifications automatiques, en push, vers votre serveur
Capacité temps réel Visibilité immédiate lors d'un accès manuel Temps réel sur demande Temps réel sur demande Temps réel sur demande Asynchrone, non adapté à la mise à jour en temps réel de la base de données
Identifiants de requête Recherche par divers critères hostedCheckoutId uniquement payment.id de la requête de paiement initiale uniquement Tout payment.id issu soit de la requête de paiement initiale soit de toute opération de maintenance ultérieure N/A (mode push)
Portée des données Statut du paiement, montant, détails client Activité de checkout du client et résultats de la transaction Statut global de la transaction Historique complet de la transaction et des opérations de maintenance Activité de transaction, opérations de maintenance, changements de statut pour le suivi des événements
Limitations temporelles Toujours disponible Expire après 3 heures Pas d'expiration Pas d'expiration N/A
Disponibilité Quel que soit le mode d'intégration Transactions via Hosted Checkout Page uniquement Quel que soit le mode d'intégration Quel que soit le mode d'intégration Quel que soit le mode d'intégration
Cas d'usage Suivi de base, contrôles ponctuels Suivi en temps réel de la progression de la session Hosted Checkout Vérification automatisée rapide du statut Analyse détaillée des transactions / données historiques Notifications automatisées, suivi des événements

Cette page vous a-t-elle été utile ?

Avez-vous des commentaires ?

Merci pour votre réponse.