Règles d’authentification IssuingVersion bêta privée

Les règles Issuing vous aident à empêcher les activités non autorisées en bloquant les autorisations qui correspondent à des conditions personnalisées. Par exemple, vous pouvez bloquer les transactions par carte en dehors de votre zone géographique, au-delà d’un certain montant, ou lorsque certains indicateurs de fraude sont présents. Accédez aux règles Issuing dans le Dashboard Stripe Issuing en sélectionnant l’onglet Règles.

Lorsqu’une autorisation est refusée en raison du déclenchement d’une règle, l’état de l’objet Authorization est défini sur closed et son attribut request_history.reason est défini sur rule_blocked.

Générer des règles par défaut

Lorsque vous vous connectez pour la première fois aux règles Issuing, vous pouvez générer un ensemble de règles adaptées à votre cas d’usage en répondant à quelques questions. Vous pouvez supprimer ou désactiver n’importe laquelle de ces règles générées, de la même manière que les règles que vous créez. Pour répondre aux questions à une date ultérieure, cliquez sur Me le rappeler plus tard.

Création d’une règle

Pour créer une règle, ouvrez l’onglet Règles dans votre Dashboard Issuing et procédez comme suit :

1. Sélectionnez + Nouvelle règle.

2. Si vous êtes une plateforme Connect, vous pouvez préciser les comptes connectés auxquels appliquer la règle. Si vous ne définissez pas un groupe cible, la règle s’applique à tous vos comptes connectés.

3. Donnez un nom descriptif à la règle.

4. Dans la liste déroulante Attributs, sélectionnez l’attribut à utiliser pour évaluer la condition de la règle. Par exemple, si vous souhaitez bloquer les autorisations en provenance d’un pays particulier, sélectionnez l’attribut Pays du marchand. Si vous souhaitez plutôt utiliser une valeur de métadonnées personnalisée, activez le bouton Utiliser mes propres métadonnées et saisissez les métadonnées.

5. Dans la liste déroulante suivante, sélectionnez l’opérateur de la condition. La liste déroulante comprend les opérateurs applicables à l’attribut sélectionné. Pour plus d’informations sur la syntaxe et le comportement de chaque opérateur, reportez-vous à la liste des opérateurs de Radar.

6. Définissez la valeur de seuil à comparer à l’attribut. En fonction de l’attribut et de l’opérateur sélectionnés, vous pouvez sélectionner une ou plusieurs des options suivantes :

• Valeur que vous saisissez ou sélectionnez dans une liste de valeurs
• Valeur d’un autre attribut
• Une valeur issue de vos propres métadonnées Pour déterminer les valeurs de seuil adaptées à votre cas d’usage, nous vous recommandons d’effectuer des tests rétroactifs sur vos données d’autorisation historiques.

Sélectionner l’attribut, l’opérateur et la valeur de seuil lors de la création d’une condition

1. Vous pouvez également ajouter un autre attribut à la règle. Reportez-vous à la section Règles complexes.
2. Activez la règle. L’activation de la règle la déploie immédiatement en production.

Évaluation des performances d’une règle

Examinez régulièrement les performances de vos règles et remplacez-les si nécessaire. La liste des règles affiche le nombre et le taux d’autorisations bloquées pour chaque règle. Pour afficher des statistiques détaillées sur une règle particulière, cliquez dessus pour ouvrir son panneau d’informations. Vous pouvez afficher le nombre et le taux par nombre des autorisations bloquées par la règle, ou leur volume et le taux par volume. Le panneau affiche également une liste des autorisations récemment bloquées par la règle, y compris la date, le marchand et le montant associés.

Indicateurs de règle Issuing

Désactiver ou supprimer une règle

Vous ne pouvez pas modifier une règle, mais vous pouvez la désactiver ou la supprimer. Sélectionnez la règle, puis cliquez sur Désactiver ou Supprimer.

• La désactivation d’une règle la désactive en production, mais la conserve dans votre liste de règles à l’état inactif et conserve son historique de performances. Vous pouvez réactiver une règle désactivée en la sélectionnant et en cliquant sur Activer.
• La suppression d’une règle l’empêche de s’exécuter en production et la supprime définitivement de votre liste de règles. Elle supprime également l’historique des performances de la règle. Vous ne pouvez pas récupérer une règle supprimée ni son historique.

Si vous souhaitez modifier une règle existante, créez-en une pour la remplacer, puis désactivez ou supprimez la règle existante.

Utilisation des métadonnées de carte

Les règles Issuing gèrent les métadonnées de la même manière que les attributs de métadonnées de Radar. Les métadonnées sont interprétées comme une chaîne ou un nombre en fonction des valeurs auxquelles elles sont comparées, et leur valeur est dérivée du champ de métadonnées de la carte émise. Les attributs de métadonnées de chaîne tiennent compte de la casse.

Pour utiliser des métadonnées comme attribut, activez l’option Utiliser mes propres métadonnées, puis saisissez les métadonnées dans le champ Attribut. Entourez le nom des métadonnées de deux-points doubles (::) et séparez les sous-champs par un deux-points simple (:). Par exemple, si les métadonnées de votre carte correspondent à { controls: { id: 'newUserControl'}}, alors pour utiliser le champ id dans une règle, saisissez-le dans le champ Attribut sous la forme ::controls:id::.

Pour utiliser des métadonnées comme valeur de comparaison, sélectionnez le type de valeur Métadonnées, puis saisissez les métadonnées dans le champ de valeur. Entourez le nom des métadonnées de deux-points doubles (::) et séparez les sous-champs par un deux-points simple (:). Par exemple, pour comparer un attribut aux métadonnées disputeCount, saisissez ::disputeCount::.

Règles complexes

Vous pouvez créer des règles complexes qui évaluent plusieurs attributs ou groupes d’attributs. Les groupes fonctionnent comme des parenthèses dans les conditions complexes de Radar. Après avoir défini une condition, ajoutez une autre condition ou un autre groupe à la même règle en cliquant sur + Ajouter puis sélectionnez les éléments à ajouter.

Les conditions appartiennent toujours à un groupe. La première condition appartient à un groupe par défaut, et toutes les conditions qui ne sont pas explicitement ajoutées à un autre groupe ou sous-groupe appartiennent également au groupe par défaut.

Par défaut, un opérateur AND est ajouté à chaque condition ou groupe. Vous pouvez le remplacer par OR dans le menu déroulant.

L’exemple suivant utilise deux conditions jointes par AND pour bloquer les autorisations des entreprises en Antarctique lorsque la devise d’autorisation (marchand) est USD.

Une règle avec plusieurs conditions

Chaque groupe affiche une liste déroulante en haut avec la valeur par défaut Correspond. Vous pouvez annuler le groupe en sélectionnant Ne correspond pas. La négation d’un groupe rend la condition vraie lorsque la valeur du groupe est « false », ce qui équivaut à appliquer un opérateur NOT au groupe.

Pour supprimer une condition ou un groupe de la règle, cliquez sur l’icône X en haut à droite de la condition ou du groupe. Si la règle ne contient qu’un seul groupe et une seule condition, vous ne pouvez pas les supprimer.

Logique de webhook

Stripe évalue les règles Issuing avant d’envoyer l’événement issuing_authorization.request. Si un webhook est à l’écoute de cet événement, les autorisations refusées par les règles Issuing ne le déclenchent pas.

Liste d’attributs

La plupart des attributs correspondent aux propriétés de l’API Authorization. Lorsque vous utilisez un opérateur de chaîne pour un attribut qui contient une valeur d’énumération, récupérez les chaînes d’énumération à partir de l’entrée de la propriété correspondante dans la documentation de l’API. Lorsque vous utilisez certains autres opérateurs, vous pouvez sélectionner des valeurs ou des attributs dans une liste déroulante.

Informations sur l’autorisation

Données de vérification

Données sur les marchands

Données enrichies sur les marchands Private preview

Vous pouvez créer des règles d’autorisation précises à l’aide des données de la propriété enriched_merchant_data de l’objet Authorization. Le tableau suivant présente certains des champs disponibles sur cette propriété. Ouvrez les autorisations en temps réel lorsque vous vous connectez à votre compte Stripe pour en savoir plus et vous inscrire à la version bêta.

Évaluation des risques

Contrôles de vélocité