Aller au contenu principal
Sur cette page

Utiliser l'activité des transactions lorsque la commande est en attente, rejetée, retardée ou présente un comportement différent de l'intégration avec le commerçant. DEUNA Admin combine un historique de paiement au niveau de l'entreprise avec des enregistrements de requêtes et de réponses techniques, permettant aux équipes opérationnelles et d'intégration d'analyser la même transaction sans avoir à changer d'outils.

L'activité des transactions est en lecture seule. La consultation d'un événement ne permet pas de relancer une requête, de modifier une commande ou de contacter un processeur de paiement.

Avant de commencer#

Votre rôle doit inclure les section "Afficher les commandes" Autorisation. Veuillez vérifier le commerçant et l'environnement sélectionnés avant de rechercher, les données sont limitées à ce contexte.

Disposer d'au moins un identifiant :

  • ID de commande ou jeton de commande
  • Transaction ID
  • Adresse e-mail du client, si cela est autorisé par votre politique de confidentialité
  • Date approximative de création

Si vous ne pouvez pas ouvrir Paiements > Commandes, demand à un utilisateur administrateur de valider Rôles et autorisations.

Choisissez la vue appropriée#

Les détails de la commande fournissent deux surfaces d'investigation connexes. Commencez par Afficher l'historique, puis utilisez Technique lorsque vous avez besoin des échanges sous-jacents.

SurfaceIdéal pourCe que cela montre
Afficher l'historiqueComprendre le cycle de vie du paiementCréation et mises à jour de commandes, création et modifications de statut de paiement, routage, 3DS et événements de fraude, avec les champs pertinents pour chaque événement.
TechniqueDiagnostiquer un échange entre un intégrateur ou un fournisseurÉvénements de transaction enregistrés, méthode HTTP et destination, code de réponse, données de requête et de réponse, horodatages et identifiants de requête, trace et span disponibles.
Journaux d'activitéActions effectuées par les utilisateurs AdministrateursQui a modifié une configuration ou effectué une action d'administrateur. Les journaux d'activité ne représentent pas le suivi de l'exécution du paiement.
Diagramme de flux
1Merchant requestCreate or update anorder2DEUNA processingRoute · authenticate ·assess risk · pay3Provider exchangeImmediate orasynchronous outcome4Admin transactionactivityRecorded lifecycle andtechnical evidence5View historyBusiness events andstatuses6TechnicalHTTP exchanges,payloads, and traceIDs

Consulter l'historique des transactions#

  1. Connectez-vous à DEUNA Admin.
  2. Sélectionnez le commerçant et l'environnement associés à la transaction.
  3. Ouvrez Paiements > Commandes.
  4. Recherchez par ID de commande ou adresse e-mail, ou utilisez les filtres de date et de paiement pour réduire la liste.
  5. Ouvrez le menu Actions de ligne et sélectionnez Afficher les détails.
  6. Pour le résumé du cycle de vie, sélectionnez Afficher l'historique. Pour consulter l'historique des transactions, ouvrez Technique.

Si la commande ne comporte aucun événement technique enregistré, Technique affiche Aucune activité technique. Cela ne permet pas d'identifier de manière autonome la cause ou le résultat du paiement.

Suivez l'historique du paiement#

Sélectionnez Afficher l'historique à partir de l'en-tête des détails de la commande. L'historique est présenté sous forme de chronologie, avec le dernier événement enregistré en premier.

Les champs exacts dépendent de l'événement :

ÉvénementPreuves que vous pouvez trouver
Commande crééeMontant initial, devise et statut de la commande.
Commande mise à jourStatut actuel de la commande et du paiement.
Paiement crééMontant et devise du paiement.
Statut du paiement mis à jourStatut du paiement et détails du processeur, de l'autorisation, du prélèvement, du remboursement ou de l'erreur applicables.
Itinéraire généréRègle et chemin appliqués, ainsi que le processeur de paiement ou de fraude représenté par cet itinéraire. Une décision d'itinérance peut créer plusieurs entrées de chronologie.
3DS mis à jourÉtat d'authentification, fournisseur 3DS et un code ou message d'erreur en cas de problème.
Analyse de la fraudeDétails disponibles concernant le fournisseur, la décision, l'évaluation des risques ou le mode "shadow".

Ne considérez pas un événement intermédiaire comme le résultat financier final. Par exemple, une authentification 3DS réussie permet de poursuivre le traitement du paiement, mais cela ne signifie pas que le paiement a été autorisé ou débité.

Inspecter les événements techniques#

Ouvrez Technique. Cette vue comporte deux zones : Activité et Données.

Activité technique dans DEUNA Admin. Toutes les valeurs de commerçant, d’utilisateur, de fournisseur, d’identifiant, de durée et de charge utile de cet exemple sont fictives.

Ce que contient la vue technique

DomaineCe qui s'afficheComment l'utiliser
Contexte de la commandeMontant total de la commande, statut de la commande et du paiement, dernière mise à jour, jeton de commande, ID de commande et ID du client.Vérifiez que vous avez ouvert la commande correcte et que l'environnement est celui prévu avant d'interpréter un événement.
Contrôles d'activitéNombre d'événements enregistrés, contrôle de tri, recherche par nom d'événement et trois modes de regroupement : Aucun, Requête et Suivi.Réduisez une longue traçabilité de transaction aux événements liés à l'opération que vous étudiez.
En-tête de groupeType de groupe, ID de requête ou ID de traçage abrégé, nombre d'événements et la somme du temps d'exécution des événements dans ce groupe.Développez ou repliez les points de contrôle pertinents et comparez une requête ou une traçabilité avec une autre.
Point de contrôle d'activitéBadge de code de réponse, nom de l'événement, heure de création de l'événement et horodatage du journal enregistré.Sélectionnez le point de contrôle qui correspond le mieux à l'étape échouée, retardée ou inattendue.
Résumé de l'échangeMéthode HTTP ou protocole, destination, ID de requête, ID de traçage et ID de span. Les identifiants disponibles incluent les contrôles de copie.Corrélez l'événement avec les journaux du commerçant, les preuves du fournisseur ou une enquête de support DEUNA.
Visualiseur de donnéesOnglets "Requête" et "Réponse", badge de code de réponse, valeur de temps écoulé (si disponible), et données de charge utile formatées avec un contrôle de copie.Comparez les données de sortie avec le résultat retourné. Copiez uniquement les preuves minimales et sécurisées nécessaires.

Le visualiseur de charge utile affiche les noms d'objets et de champs pour que vous puissiez inspecter la structure de l'échange. Les valeurs et le niveau d'imbrication varient en fonction de l'événement et du fournisseur. Un champ présenté dans l'exemple n'est pas garanti d'apparaître dans chaque transaction.

Lire un événement

  1. Sélectionnez un événement dans Activité. Sur mobile, développez l'événement.
  2. Vérifiez le nom de l'événement et l'horodatage.
  3. Compare la méthode HTTP, la destination et le code de réponse avec l'opération attendue.
  4. Basculer entre Demande et Réponse dans Données.
  5. Enregistrer l'ID de la requête, l'ID de suivi ou l'ID de span lorsque ces identifiants sont présents.

Lorsqu'un événement possède une 4xx réponse, l'interface d'administration DEUNA peut afficher Message d'erreur Au-dessus des données de réponse. Les autres codes de réponse restent visibles dans l'événement et dans le panneau de données.

Le code de réponse indique l'état de la transaction technique, et non nécessairement le résultat final du paiement. Avant de traiter une commande, comparez ce code avec Statut de paiement, Afficher l'historique, et notifications de statut asynchrones.

Événements produits lors d'un processus de commande

Les activités disponibles dépendent du chemin suivi par la transaction. Les groupes courants comprennent :

ScèneExemples visibles dans l'activitéQue vérifier
CommandeUne nouvelle commande a été créée ; la commande a été mise à jourLes identifiants de commande et l'état sont retournés à l'intégration du commerçant.
RoutageGénérer le routage de paiementLe chemin sélectionné et les échanges avec le prestataire.
PaiementGénérer le paiement ; demander l'autorisationDemander le montant et la devise, réponse du processeur et statut du paiement résultant.
AuthentificationÉvaluation 3DS démarrée, contestée, mise à jour, terminée ou échouéeIndiquer si une action du client était nécessaire et si le traitement du paiement a continué par la suite.
Vérification de l'adresseValidation AVS, suppression ou annulationRésultat de validation normalisé et l'action de paiement qui en a résulté.
FraudeGénérer l'analyse du moteur de prévention de la fraude ; évaluation "shadow"Résultat du prestataire et si la transaction a continué vers le traitement du paiement ou la revue.
Opérations post-paiementCapture, capture partielle, remboursement, remboursement partiel, annulation ou demande d'annulationMontant de l'opération et identifiant, réponse et l'événement de statut de paiement ultérieur qui confirme le résultat.

Certains événements enregistrent qu'une étape s'est produite, mais ne contiennent pas de corps de requête ou de réponse. La disponibilité des données varie en fonction de l'opération et du prestataire.

Regrouper et rechercher le trace#

Dans Activité, utilisez les contrôles suivants pour réduire une trace longue :

  • Aucun affiche chaque événement dans une liste plate.
  • Demande regroupe les événements qui partagent un ID de requête. Utilisez-le pour suivre le travail initié par une requête entrante.
  • Trace regroupe les événements qui partagent un ID de trace. Utilisez-le pour suivre une transaction à travers les étapes de traitement connexes.
  • Rechercher un événement Filtre par le nom de l'événement affiché.
  • Trier l'activité inverse l'ordre des événements.

Lorsqu'un événement n'a pas de valeur pour l'identifiant de regroupement sélectionné, DEUNA Admin le place dans Orphelin. Cet événement peut encore être utile lorsque son ID de transaction, son horodatage et les événements voisins correspondent à la fenêtre d'incident.

Enquêter sur un paiement échoué ou retardé#

Suivez cet ordre afin d'éviter de confondre une erreur technique intermédiaire avec le résultat final :

  1. Vérifiez l'environnement, le statut actuel de la commande, le statut actuel du paiement. Order IDet Transaction ID.
  2. Ouvrez Afficher l'historique et identifier le dernier événement du cycle de vie.
  3. Ouvrez Technique et regrouper par Trace.
  4. Trouvez l'événement de paiement, de routage, d'authentification, de lutte contre la fraude ou de suivi correspondant.
  5. Comparez son code de réponse et ses données avec l'événement suivant dans la trace.
  6. Vérifiez si une mise à jour ultérieure de l'état a permis de récupérer le paiement, de le transférer à un autre prestataire ou de confirmer un échec définitif.
  7. Comparez le statut final de DEUNA avec le statut reçu via votre webhook de paiement.

En cas de rejet, consultez la référence publique des codes d'erreur en utilisant le code d'erreur DEUNA. Les codes et messages spécifiques au fournisseur doivent être interprétés en fonction de la documentation du fournisseur.

Préparez les preuves pour le support#

Lorsque vous avez besoin du support DEUNA pour une enquête, fournissez les preuves minimales requises :

  • Nom du commerçant et environnement
  • ID de commande ou jeton de commande
  • Transaction ID
  • Horodatage UTC et période de l'incident
  • Nom de l'événement et code de réponse affichés
  • ID de la requête, ID de suivi et ID de span, si disponibles
  • Statut actuel de la commande et du paiement
  • Comportement attendu et comportement observé

Envoyer uniquement le payload complet lorsque le support le demande via un canal approuvé.

Limites et récupération#

  • L'activité de transaction est un enregistrement d'observabilité, et non un mécanisme de relecture ou de nouvelle tentative.
  • Tous les stades ne produisent pas un corps de requête et de réponse.
  • Les événements peuvent arriver après la requête initiale lorsque le fournisseur signale un résultat asynchrone.
  • L'absence d'activité ne permet pas de déterminer si le fournisseur a traité la transaction.
  • Le statut actuel du paiement ou de la commande est la vue administrative autoritaire ; utilisez les webhooks et la réponse API appropriée pour la gestion de l'état côté intégration.

Si les identifiants et l'environnement sont corrects, mais que l'événement requis est toujours absent, rassemblez les preuves ci-dessus et contactez le support DEUNA. Ne réessayez pas une opération de paiement avant d'avoir confirmé qu'il est sûr de le faire.

Prochaines étapes#