Retour au blog E-commerce - 6 min

Détecter une commande bloquée avant l’appel du client

Repérer une commande bloquée : surveiller le code HTTP du tunnel, l’URL de retour paiement et les commandes restées en attente.

Une commande bloquée est un parcours qui ne peut plus aboutir : page de tunnel en erreur, retour de paiement qui n’atteint pas la boutique, ou commandes qui s’accumulent dans un statut intermédiaire. Le client, lui, voit un bouton qui tourne ou un e-mail qui n’arrive pas. Le repérage consiste à surveiller quelques URL et un état de commande, pas à attendre le ticket du support.

Ce qui se surveille, concrètement

PointContrôleIncident
Panier et page de commandeCode HTTP 200, formulaire présent, pas une page de maintenance500, 502, ou HTML « en travaux » servi à la place du tunnel
URL de retour après paiementLa route existe et répond au prestataire (souvent un 200 vide ou une redirection vers la confirmation)404 ou 500 : le client a payé, la commande ne passe pas au statut payé
WebhookLe journal du prestataire montre des envois acceptésFile d’échecs, signature refusée, délai dépassé
StatutsQuelques commandes « en attente » sont normalesToutes les commandes de l’heure restent en attente alors que le prestataire les marque payées

Le détail des codes renvoyés par l’API de paiement est dans erreur de l’API de paiement. Ici, on décide quoi interroger pour s’en apercevoir sans ouvrir chaque commande.

L’accueil et le blog ne sont pas des témoins. Une sonde qui ne teste que la home reste verte pendant que /commande est en erreur. Placez le contrôle sur l’URL réelle du tunnel (celle du thème, pas une URL devinée).

Mettre l’alerte au bon endroit

  1. Notez trois URL : panier, commande, confirmation. Ajoutez l’URL de notification documentée par le prestataire (Stripe, PayPal, PayPlug, ou le module de la banque).
  2. Interrogez-les de l’extérieur, sans cookie d’admin. Un 200 avec le titre de la boutique ne suffit pas si le corps est une erreur PHP habillée : exigez un mot stable du formulaire (« paiement », « récapitulatif ») ou, pour le webhook, le code prévu quand la requête est refusée faute de signature (souvent 400, pas 500).
  3. Dans l’admin, un filtre « statut en attente, créées il y a plus de 30 minutes » se consulte au moins lors des campagnes. Une poignée de lignes est normale. Une rafale après un déploiement ne l’est pas.
  4. Croisez avec le tableau de bord du prestataire : paiements réussis d’un côté, commandes toujours « pending » de l’autre. L’écart est le signal.

Un outil qui rejoue ces URL et prévient quand le code change couvre les heures où personne n’a le tunnel ouvert. SiteGarde sert à ça sur les adresses que vous avez choisies : le tunnel, pas seulement la page d’accueil. Le correctif, lui, reste dans les journaux et chez le prestataire.

Ce que l’alerte ne doit pas faire

Ne pagez pas à chaque paiement refusé par la banque (fonds, 3-D Secure abandonné). Ce sont des réponses métier, souvent un HTTP réussi avec un code d’échec dans le corps. L’alerte technique porte sur l’impossibilité de dialoguer : délai, 5xx, signature de webhook en échec pour tout le monde.

Ne confondez pas non plus avec un tunnel lent. Un 200 en huit secondes est un problème de performance, traité dans performance du checkout, pas une commande bloquée. Les deux peuvent coexister : on les sépare dans le message d’astreinte.

Quand l’alerte part, la fiche d’incident commence tout de suite : heure, URL, code, nombre de commandes coincées. Le modèle est dans documenter un incident. Le client final, lui, a besoin d’un statut honnête au support (« le paiement ne confirme pas depuis 14 h 10 »), pas d’une promesse de délai.

Questions fréquentes

Une commande en attente de paiement est-elle toujours un incident ?

Non. Un client qui abandonne au 3-D Secure laisse une commande en attente. L’incident, c’est quand toutes les nouvelles commandes restent dans cet état, ou quand l’URL de retour paiement ne répond plus.

Quelle URL surveiller en plus de l’accueil ?

La page panier, la page de commande, et l’URL de retour ou de webhook que le prestataire de paiement appelle. L’accueil peut répondre 200 pendant que le tunnel renvoie 500.

Le stock à zéro déclenche-t-il la même alerte ?

Non. Une fiche en rupture peut être normale. L’alerte utile est : le bouton d’ajout ou la validation échoue alors que le stock affiché est positif, ou le paiement n’est plus joignable.

Surveiller mes URL