Documentation ComusThumbz
Connexion Admin

Registres de facturation

Ce que fait cette page

Cette page vous montre tout ce qui se passe entre votre site et vos fournisseurs de paiement. Chaque fois qu'un paiement est traité, qu'un abonnement est renouvelé, ou que quelque chose ne va pas avec une transaction, il est enregistré ici. Utilisez cette page pour vérifier que les paiements fonctionnent correctement et pour enquêter sur tout problème.

[Screenshot: page-overview]


Comment arriver ici

Naviguez vers Panneau d'administration > Facturation > Registres


Comprendre la page

Lorsque vous ouvrez cette page, vous verrez quatre zones principales : une barre de statistiques en haut, un ensemble de filtres en dessous, la table de bord principale et des boutons de navigation en bas.

Barre statistique

En haut de la page, quatre cartes colorées vous donnent un résumé rapide de votre activité de journal :

CarteCe qu'il montre
Total des journauxLe nombre total d'entrées de journaux (accent vert)
Déboguer les messagesDossiers d'activités détaillés (accent gris)
Info MessagesMessages opérationnels normaux comme les paiements réussis (accent bleu)
Messages d'erreurProblèmes qui nécessitent votre attention (accent rouge)
Conseil : Surveillez le nombre de messages d'erreur. Sur un site sain, les erreurs devraient représenter moins de 5 % de vos journaux. Si vous voyez des erreurs grimper, enquêtez immédiatement.

[Screenshot: facturation-logs-stats]

Panneau filtre

En dessous de la barre de statistiques, vous trouverez des filtres qui vous permettent de réduire les entrées de journal que vous voyez. Vous pouvez filtrer par fournisseur de paiement, type de message, une recherche par mot-clé et une plage de dates. Plus de détails sur l'utilisation des filtres sont dans la section Tâches communes ci-dessous.

Tableau des journaux

La zone principale de la page est un tableau listant chaque entrée de journal, avec les entrées les plus récentes en haut. Chaque ligne montre :

ColonneCe qu'il montre
NuméroUn numéro unique pour l'entrée du journal
Date/heureQuand l'événement s'est produit
FournisseurQuel fournisseur de paiement a été impliqué
TypeQue l'entrée soit un message de débogage, d'information ou d'erreur
MessageUn bref résumé de ce qui s'est passé
DétailsInformations supplémentaires (déplacer cette colonne pour voir le contenu complet)

Les lignes sont codées en couleur afin que vous puissiez rapidement repérer les problèmes:

  • Fond rouge -- Erreurs pouvant nécessiter votre attention
  • Fond gris -- Entrées de débogage avec détails techniques
  • Fond blanc -- Entrées d'information normales

Remarque: Si un message dans la colonne Détails semble coupé, survolez votre souris dessus. Le contenu complet va s'étendre afin que vous puissiez le lire sans quitter la page.

Boutons d'action

Au bas de la page, vous trouverez des boutons d'accès rapide pour sauter aux pages connexes.


Tâches communes

Comment afficher les journaux récents

  1. Allez à Panneau d'administration > Facturation > Registres.
  2. La page affiche automatiquement les entrées les plus récentes en premier.
  3. Faites défiler le tableau pour examiner les activités.
  4. Plongez sur le Détails colonne sur n'importe quelle ligne pour voir tous les détails de cette entrée.

Comment filtrer par fournisseur de paiement

Utilisez ceci lorsque vous voulez voir l'activité d'un seul fournisseur de paiement (par exemple, seulement PayPal ou seulement Stripe).

  1. Sélectionnez le fournisseur à partir du Fournisseur de paiement à la baisse.
  2. Cliquez sur Appliquer les filtres.
  3. Le tableau et les cartes statistiques sont mis à jour pour ne montrer que les entrées de ce fournisseur.

Conseil : Ceci est particulièrement utile lorsque vous dépannez un problème avec un fournisseur de paiement spécifique.

Comment filtrer par type de message

Utilisez ceci pour vous concentrer sur un type spécifique d'entrée de journal.

  1. Sélectionnez un type dans le Type de message déroulant & #160;:
  • Débogues -- Détails techniques généraux
  • Informations -- Événements normaux comme les paiements réussis
  • Erreur -- Problèmes nécessitant une attention particulière
  1. Cliquez sur Appliquer les filtres.

Conseil : Pour vérifier rapidement les problèmes, définissez le type de message à Erreur et de revoir ce qui se passe.

Comment filtrer par plage de dates

Utilisez ceci pour regarder les journaux d'une période donnée.

  1. Cliquez sur Date choisir une date de début.
  2. Cliquez sur Jusqu'à et choisir une date de fin.
  3. Cliquez sur Appliquer les filtres.
  4. Le tableau ne montre que les entrées à partir de cette plage de dates (les deux dates sont entièrement incluses).

Comment rechercher les journaux

Utilisez ceci lorsque vous recherchez quelque chose de spécifique, comme un mot-clé ou un numéro de référence particulier.

  1. Tapez votre terme de recherche dans le Messages de recherche champ.
  2. Cliquez sur Appliquer les filtres.
  3. Les résultats montrent les entrées où votre terme de recherche apparaît dans le message ou les détails.

Termes de recherche utiles pour essayer:

RechercherPour trouver
webhookLivraisons de notification de paiement
failedOpérations non achevées
subscriptionManifestations liées à l'abonnement
amountInscriptions mentionnant les montants de paiement

Comment combiner plusieurs filtres

Vous pouvez utiliser tous les filtres en même temps pour une recherche très ciblée.

  1. Sélectionner un Fournisseur de paiement.
  2. Sélectionner un Type de message.
  3. Définir un Date et Jusqu'à portée.
  4. Saisissez un mot-clé dans Messages de recherche.
  5. Cliquez sur Appliquer les filtres.

Seules les entrées correspondant à tous vos critères apparaîtront, et les cartes statistiques seront mises à jour pour correspondre.

Comment effacer tous les filtres

  1. Cliquez sur Réinitialiser bouton à côté du bouton Appliquer les filtres.
  2. La page reprend toutes les entrées de journal sans filtres appliqués.

Navigation entre les pages

Le tableau de bord montre 100 entrées par page. Si vous avez plus d'entrées que cela, utilisez la navigation de page ci-dessous le tableau pour déplacer entre les pages. Vous verrez Précédent et Suivant flèches avec les numéros de page. Une ligne ci-dessous vous indique sur quelle page vous êtes et combien d'entrées existent au total.

Remarque: Vos filtres restent actifs lorsque vous vous déplacez entre les pages. Vous n'avez pas besoin de les re-appliquer.


Au bas de la page, trois boutons vous permettent de sauter vers des zones connexes :

BoutonOù ça te mène
Gérer les fournisseursLa page où vous configurez vos fournisseurs de paiement
Gérer les paquetsLa page où vous créez des abonnements et accédez aux paquets
Afficher les transactionsLa page montrant les opérations de paiement individuelles

Conseils pour les nouveaux utilisateurs

Conseil :
  • Vérifiez vos journaux de facturation au moins une fois par jour, surtout lorsque vous avez d'abord configuré un nouveau fournisseur de paiement.
  • Un pic soudain dans les messages d'erreur signifie habituellement quelque chose de changé avec votre fournisseur de paiement -- vérifiez les paramètres de votre fournisseur.
  • Utilisez le filtre de la plage de dates pour comparer la semaine d'activité sur une semaine et repérer des motifs inhabituels.
  • Si vous voyez un nom de fournisseur montrant un nombre au lieu d'un nom, cela signifie que le fournisseur a été supprimé de vos paramètres, mais ses anciens journaux existent encore. C'est normal et rien à craindre.


Surveiller votre santé de paiement

Voici un planning simple pour assurer le bon déroulement de vos paiements :

Combien de foisQuoi vérifier
Tous les joursRegardez le nombre d'erreurs -- y a-t-il de nouvelles erreurs au cours des dernières 24 heures?
Tous les joursAperçu du volume global du journal -- Votre site enregistre-t-il les paiements comme prévu?
SemaineComparez le taux d'erreur de cette semaine à la semaine dernière -- est-ce qu'il monte ou baisse?
MensuelExaminer l'activité de chaque fournisseur de paiement pour s'assurer qu'ils fonctionnent tous

Comprendre les taux d'erreur

Taux d'erreurCe que ça signifieQue faire
Moins de 1%Tout est sainPoursuivre la surveillance normale
1% à 5%Des problèmes mineurs peuvent existerRegardez les erreurs du haut et voyez s'il y a un motif
5% à 10%Quelque chose a besoin d'attentionVérifiez immédiatement les erreurs et vérifiez les paramètres de votre fournisseur
Plus de 10 %Problème graveArrêtez et enquêtez avant qu'il affecte vos revenus
Avertissement : Si votre taux d'erreur saute soudainement au-dessus de 10%, vérifiez immédiatement les paramètres de votre fournisseur de paiement. Les causes courantes comprennent les identifiants expirés, les adresses Webhook modifiées ou les pannes du fournisseur.

Reconnaître les patrons de log communs

Un paiement réussi ressemble à ça

Vous verrez une série de messages Info dans l'ordre:

  1. Une notification reçue du prestataire de paiement
  2. La notification a été vérifiée avec succès
  3. Une transaction créée pour l'utilisateur
  4. L'abonnement ou l'accès mis à jour

Succès : Lorsque vous voyez ce modèle, votre système de paiement fonctionne correctement.

Un paiement raté ressemble à ça

Vous verrez un ou plusieurs messages d'erreur, souvent avec un message Info avant ou après:

  1. Une notification reçue du prestataire de paiement
  2. Une erreur indiquant ce qui s'est mal passé (comme "le paiement a été refusé" ou "la vérification a échoué")

Que faire lorsque vous voyez des erreurs

  1. Filtrer par Type de message : Erreur pour voir toutes les erreurs récentes.
  2. Rechercher des modèles -- les erreurs proviennent-elles toutes du même fournisseur? Le même type de message ?
  3. Plongez sur le Détails colonne pour plus d'informations sur chaque erreur.
  4. Prendre des mesures en fonction de ce que vous trouvez :
Modèle d'erreurQue faire
"clé API invalide" ou "signature échouée"Allez dans les paramètres de votre fournisseur de paiement et vérifiez que vos identifiants sont corrects
"Paiement refusé"C'est normal -- cela signifie que le mode de paiement d'un client a été rejeté par leur banque
"Temps de connexion"C'est généralement temporaire. Si cela continue, votre serveur peut avoir un problème de connectivité -- contactez votre fournisseur d'hébergement
"L'utilisateur n'a pas trouvé"Un paiement est venu pour un compte utilisateur qui n'existe pas. Vérifiez si le compte du client a été supprimé

Dépannage

Aucune entrée de journal n'apparaît

Ce que vous voyez : La page charge mais le tableau est vide et toutes les statistiques montrent zéro.

Comment le réparer :

  1. Assurez-vous d'avoir au moins un fournisseur de paiement configuré. Allez à Panneau d'administration > Facturation > Fournisseurs de paiement et vérifier.
  2. Si vous venez de configurer vos fournisseurs de paiement, les journaux n'apparaîtront qu'après une véritable activité de paiement (une transaction de test, un webhook de votre fournisseur, etc.).
  3. Vérifiez que vos filtres ne sont pas trop restrictifs. Cliquez sur Réinitialiser pour effacer tous les filtres et voir si les entrées apparaissent.

La colonne Détails ne s'élargit pas lorsque je plane dessus

Ce que vous voyez : Vous survolez une entrée tronquée dans la colonne Détails mais elle ne se développe pas.

Comment le réparer :

  1. Essayez de rafraîchir la page.
  2. Essayez un navigateur Web différent pour voir si le problème persiste.
  3. Si l'entrée indique « Pas de détails supplémentaires », il n'y a rien de plus à voir pour cette entrée -- elle n'a tout simplement pas d'informations supplémentaires.

Un fournisseur de paiement affiche comme un nombre au lieu d'un nom

Ce que vous voyez : Dans la colonne Fournisseur, vous voyez un nombre (comme "3") au lieu d'un nom de fournisseur.

Comment le réparer :
Cela arrive quand un fournisseur de paiement a été supprimé de vos paramètres, mais ses entrées de journal existent toujours. Les journaux sont toujours valides -- le système ne peut plus chercher le nom du fournisseur. Cela n'affecte pas le fonctionnement de votre site.

Les filtres ne semblent pas fonctionner

Ce que vous voyez : Vous appliquez des filtres, mais les résultats ne semblent pas corrects.

Comment le réparer :

  1. Cliquez sur Réinitialiser pour effacer tous les filtres.
  2. Appliquer un seul filtre à la fois pour réduire le filtre qui pourrait causer la confusion.
  3. Vérifiez deux fois votre plage de dates -- assurez-vous que la Date est avant Jusqu'à.


PageQuand l'utiliser
Fournisseurs de paiementPour configurer ou modifier les paramètres de votre processeur de paiement (crédentielles, adresses webhook, etc.)
Opérations de facturationPour voir les paiements individuels, les remboursements et les frais d'abonnement
Forfaits d'accèsPour créer ou modifier les abonnements et les options d'achat uniques disponibles sur votre site