# Alertes d’état Stripe Surveillez l’intégrité de vos intégrations API grâce à des alertes et des informations. Les alertes d’état de Stripe permettent une surveillance en temps réel et envoient des notifications automatiques pour les problèmes qui affectent vos flux de paiement ou toute intégration avec les produits Stripe. Ce service alerte votre équipe en cas de tendances inattendues en matière d’échecs de requêtes, de volume de transactions ou de latence. Évaluez ces tendances pour voir si elles ont un impact sur votre capacité à traiter les paiements ou à utiliser efficacement les produits Stripe. > Le recours aux alertes d’état engage votre seule responsabilité. Stripe ne saurait être responsable des pertes, des dommages ou des coûts liés à l’exactitude ou à l’inexactitude des alertes, ni des mesures que vous pourriez prendre ou vous abstenir de prendre en fonction des alertes. ## Disponibilité Vous pouvez recevoir des alertes de santé en fonction de votre compte Stripe. ### Niveau d’alerte de santé - **Niveau Basic** : tous les utilisateurs Stripe sont notifiés par e-mail et via Workbench des alertes de santé correspondant aux [code d’état d’erreur](https://docs.stripe.com/health-alerts.md#error-status-codes-for-api-error-alerts) `402` (paiement refusé en raison d’une panne d’un partenaire) et `500` (requête API échouée suite à une panne Stripe). - **Niveau Advanced** : les utilisateurs des [offres de support Croissance, Premium ou Entreprise](https://stripe.com/support-plans) de Stripe reçoivent des alertes de santé par e-mail, dans Workbench, et via des événements webhook. Consultez la section [alertes plus détaillées](https://docs.stripe.com/health-alerts.md#advanced-tier-alert-categories) pour en savoir plus. ### Connect En tant que plateforme [Connect](https://docs.stripe.com/connect.md), vous recevez des alertes de santé pour votre compte de la plateforme et pour tous les comptes connectés associés. ### Organisations Avec [Stripe Organizations](https://docs.stripe.com/get-started/account/orgs.md), il est possible de visualiser les alertes et analyses de l’ensemble de vos comptes dans une seule interface sur Workbench. ## Canaux de communication Stripe transmet les alertes de santé par les différents canaux de communication pour notifier votre équipe des incidents affectant l’écosystème Stripe et, le cas échéant, des étapes suivantes à suivre. | | Canal | Notification | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | Notifications par e-mail | Stripe envoie des alertes par e-mail aux adresses e-mail ou aux listes de distribution configurées. | | Onglet État dans Workbench | Onglet interactif dans [Workbench](https://docs.stripe.com/workbench/health.md) présentant l’historique des 30 derniers jours des alertes, avec indication du niveau de gravité, de l’état (ouvert ou résolu) et des requêtes affectées. | | Événements de webhook | Les alertes sont transmises en temps réel à l’endpoint webhook de votre application dès qu’un [événement de santé](https://docs.stripe.com/api/v2/core/events/event-types.md#v2_event_types-v2.core.health.api_error.firing) survient dans votre compte Stripe. Vous pouvez les intégrer à vos systèmes internes de notification, comme Slack ou Pagerduty, pour une surveillance proactive. | ## Configurer les préférences des alertes de santé Si vous êtes l’administrateur de votre compte Stripe, vous pouvez choisir de recevoir ou non les alertes de santé du niveau Basic via **Paramètres** > [Préférences en matière de communication](https://dashboard.stripe.com/settings/communication-preferences#api). Pour configurer des adresses e-mail ou des listes de diffusion pour les alertes de santé du niveau Advanced, prenez contact avec votre responsable de compte technique. En tant qu’administrateur d’une [organisation Stripe](https://docs.stripe.com/get-started/account/orgs.md) recevant des alertes de santé du niveau Advanced, vous pouvez configurer les préférences pour l’ensemble des comptes de l’organisation via **Paramètres** > [Gestion de la communication](https://dashboard.stripe.com/org/settings/communication-management). ## Catégories d’alertes du niveau Basic ### Augmentation des erreurs API Ces alertes suivent les requêtes API liées aux produits de paiement Stripe. Elles vous informent de tout problème susceptible d’affecter la capacité de votre intégration à traiter les paiements. Les codes d’état d’erreur pour les alertes d’augmentation des erreurs d’API incluent 402 et 500. En savoir plus sur les [codes d’erreur](https://docs.stripe.com/error-codes.md) et comment les résoudre. Stripe envoie des alertes d’augmentation des erreurs d’API pour : | Product | Description de l’alerte | | -------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [API Payment Intents](https://docs.stripe.com/payments/payment-intents.md) | Ces alertes sont généralement liées à des échecs d’événements API liés à la configuration, à la gestion, à la confirmation et à la capture de [PaymentIntents](https://docs.stripe.com/api/payment_intents.md). | | [API Bank Accounts](https://docs.stripe.com/api/customer_bank_accounts.md) | Ces alertes concernent les défaillances liées à l’établissement d’une connexion sécurisée entre un utilisateur et une institution financière (telle qu’une banque), ainsi que les problèmes liés à la récupération de données financières et à l’authentification des sessions de connexion. Cette connexion facilite l’échange de données, y compris les informations relatives aux comptes et aux transactions. | | [Stripe Terminal](https://docs.stripe.com/terminal.md) | Inclut la couverture des actions spécifiques à l’API propres à Terminal, telles que : - [Configuration et activation du token](https://docs.stripe.com/api/terminal/connection_tokens/object.md) - [Initiation du remboursement](https://docs.stripe.com/api/terminal/readers/refund_payment.md) - [Attestation de l’appareil](https://docs.stripe.com/api/terminal/readers/object.md) - [Traitement du Payment Intent](https://docs.stripe.com/api/errors.md) | | [Stripe Issuing](https://docs.stripe.com/issuing.md) | Les alertes en cas d’échec des requêtes liées à l’[API Issuing](https://docs.stripe.com/api/issuing/authorizations.md) portent sur l’authentification, l’autorisation, la création, la récupération et les mises à jour des cartes de paiement émises par Stripe. | #### Codes d’état d’erreur pour les alertes d’erreur d’API | Code d’état d’erreur | Cause possible | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `402` | Indique que la requête contenait des paramètres valides, mais qu’elle a échoué en raison de problèmes de validation de la transaction financière ou du moyen de paiement. | | `424` | Se produit lorsque la requête a échoué parce que la requête API dépendait d’une action précédente qui a elle-même échoué. | | `500` | Indique des problèmes côté serveur avec Stripe. Bien que rares, ces erreurs peuvent signifier qu’il y a un problème avec nos serveurs ou qu’un délai d’attente est causé par des appels problématiques de votre part. Stripe enquête toujours sur les erreurs `500` et vous informe de leur résolution. | ### Erreurs liées aux moyens de paiement Une hausse des erreurs liées aux moyens de paiement indique une augmentation des [paiements refusés](https://docs.stripe.com/declines.md) pour le moyen de paiement concerné. Cela peut résulter d’un problème technique lié au moyen de paiement, à l’émetteur ou à Stripe. Certains moyens de paiement, tels que le [ACH Direct Debit](https://docs.stripe.com/payments/ach-direct-debit.md), empêchent la confirmation du statut du paiement pendant les délais de notification. Le statut de paiement `processing` indique que Stripe n’a pas encore pu confirmer si le paiement est à l’état `failed` ou `succeeded`. Consultez la section [Notifications immédiates ou différées](https://docs.stripe.com/payments/payment-methods.md#payment-notification) pour plus de détails. ## Catégories d’alertes du niveau Advanced Outre les catégories d’alertes du niveau Basic, les clients du niveau Advanced bénéficient également des catégories d’alertes suivantes : ### Augmentation des erreurs d’intégration Ces alertes suivent les erreurs susceptibles d’affecter les fonctionnalités de paiement dans votre intégration, notamment les problèmes de limitation du taux de requêtes. Elles vous signalent les incidents liés à votre intégration Stripe pouvant compromettre votre capacité à traiter des paiements. Les codes d’état d’erreur concernés par les alertes d’augmentation des erreurs d’intégration incluent les codes 400, 409 et 429. Pour en savoir plus, consultez la section [codes d’erreur](https://docs.stripe.com/error-codes.md) pour apprendre à les corriger. #### Codes d’état d’erreur pour les alertes d’erreur d’intégration | Code d’état d’erreur | Cause possible | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `400` | Indique des requêtes mal formées, dont la syntaxe n’est pas comprise par le serveur. Vérifiez la méthode d’API indiquée dans le message d’alerte dans votre intégration. | | `409` | Se produit en cas de conflit, par exemple lorsque vous essayez de créer une ressource qui existe déjà. | | `429` | Indique un trop grand nombre de requêtes envoyées dans un laps de temps donné, souvent en raison d’une limitation du débit. Un nombre élevé dans cette catégorie peut signifier qu’un paramètre obligatoire a été omis. | ### Latence API La mesure de latence de l’API mesure les variations de latence par compte Stripe pour des méthodes d’API spécifiques. Les alertes de latence élevée peuvent indiquer des problèmes potentiels dans le traitement des paiements et sont surveillées par Stripe pour garantir des réponses rapides. ### Alertes d’anomalies Les alertes d’anomalie exploitent le machine learning (ML) pour identifier en quasi temps réel toute baisse ou variation soudaine dans la performance des paiements. Le tableau ci-dessous présente les différents types d’alertes d’anomalie. | Alerte en cas d’anomalie | Description | | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Refus d’autorisation de carte bancaire** | Une baisse soudaine des [taux d’autorisation](https://docs.stripe.com/payments/analytics/acceptance.md), qui réduit le taux global de réussite des paiements par carte bancaire. Lorsque ces alertes sont disponibles, elles précisent également les segments de trafic de paiement qui se sont dégradés. Par exemple, l’alerte peut indiquer la banque émettrice de la carte bancaire ou le type de carte concerné. Consultez le guide intitulé [Comment réduire le nombre de paiements refusés par les réseaux](https://stripe.com/guides/optimizing-authorization-rates#how-to-increase-authorization-rates) pour connaître les actions à mettre en place pour essayer d’améliorer les taux d’autorisation. | | **Refus d’autorisation de terminal** | Une baisse soudaine des paiements Terminal réussis. Ces alertes vous informent de manière proactive lorsque Stripe détecte des baisses significatives dans les approbations de paiement sur vos appareils Terminal. Ces notifications couvrent tous les moyens de paiement pris en charge, y compris les principaux réseaux de cartes bancaires et les systèmes de débit locaux, et peuvent vous aider à identifier et à résoudre les problèmes de traitement. | | **Hausse des transactions frauduleuses** (Private preview) | Une hausse soudaine des [transactions frauduleuses](https://docs.stripe.com/disputes/prevention.md), augmentant le risque de pertes. | | **Baisse du volume de paiements** (Private preview) | Alertes basées sur le machine learning (ML) qui notifient les utilisateurs des diminutions de volume de paiements, en prenant en compte les variations hebdomadaires et saisonnières. Ces baisses peuvent avoir plusieurs causes, comme des erreurs dans la configuration de votre compte Stripe, une maintenance planifiée de votre site web ou de votre application mobile, ou des variations saisonnières de votre activité. | ### Alertes de latence de webhook Pour réduire les interruptions de service, nous surveillons l’évolution de la latence des webhooks pour nous assurer que les mises à jour en temps réel sont fournies rapidement. Pour en savoir plus sur les erreurs et alertes propres aux webhooks, consultez la page [Erreurs](https://docs.stripe.com/api/errors.md#errors-code). ### Expiration des requêtes Issuing (Private preview) Les expirations des demandes Issuing sont générées en cas d’un volume élevé d’expiration des demandes d’autorisation de webhook [Stripe Issuing](https://docs.stripe.com/issuing.md). Ces demandes d’autorisation informent votre équipe qu’elle doit vérifier les paramètres de la page [Issuing](https://dashboard.stripe.com/settings/issuing/authorizations) dans le Dashboard. Pour vérifier les paramètres, accédez à **Paramètres** > **Émission** > **Autorisations** > **Approbations** dans le Dashboard. ### Erreurs d’émission (Private preview) Pour [Stripe Issuing](https://docs.stripe.com/issuing.md), nous surveillons les délais d’attente d’autorisation des webhooks avec votre intégration Issuing. Nous vous informons lorsque nous constatons une augmentation des délais d’attente des webhooks pour les requêtes d’autorisation Issuing. ### Erreurs liées au mode de facturation(Private preview) Surveillez les erreurs liées au mode de facturation et à la [facturation à l’usage](https://stripe.com/billing/usage-based-billing) de Stripe. ## Générer des alertes de santé et des analyses de test Il est possible de générer des alertes de santé et des analyses de test via l’onglet Plans de Workbench. Ces alertes de test sont affichées dans l’onglet Santé, sans déclencher d’envoi de notifications par e-mail. ## See also - [Alertes sur la santé de Workbench](https://docs.stripe.com/workbench/health.md) - [Codes d’erreur de l’API Stripe](https://docs.stripe.com/api/errors.md#errors-code)