Une empreinte d'identification est un identifiant unique attribué à un numéro de carte de crédit ou à un compte bancaire associé à un compte Stripe. Par conséquent, le suivi des empreintes d'identification dans votre base de données vous permet d'identifier les clients récurrents. Lorsqu'un client ajoute une carte ou un compte bancaire, vous devez d'abord vérifier que l'empreinte d'identification correspondante ne figure pas déjà dans votre base de données afin de déterminer si vous devez créer un client ou retourner une erreur.
Pour les cartes bancaires, utilisez la propriété card.fingerprint
de l'objet Payment Method. Il existe également des propriétés d'empreinte d'identification pour d'autres formes de paiement, telles que us_bank_account.fingerprint
et sepa_debit.fingerprint
.
Pour les intégrations héritées (qui n'utilisent pas d'API PaymentMethod ni PaymentIntent), les propriétés d'empreinte d'identification sont indiquées sous les objets Token, Card et Bank Account.
Vous pouvez ainsi détecter les tentatives d'inscriptions multiples avec une même carte bancaire (par exemple, pour obtenir plusieurs fois la même remise) et les bloquer. Cela permet en outre de supprimer les cartes obsolètes en cas d'ajout de cartes associées à la même empreinte d'identification avec des dates d'expiration plus récentes.
Chaque compte se voit attribuer une empreinte d'identification. Si une même carte est ajoutée à plusieurs comptes indépendants, elle est alors associée à différentes empreintes d'identification. Les cartes et les comptes bancaires créés par des plateformes pour des comptes connectés sont associés à la même empreinte d'identification pour l'ensemble de ces comptes connectés.
Notez que les cartes bancaires conservent leurs empreintes d'identification au fil des renouvellements, car la date d'expiration n'entre pas en compte dans la définition de ces empreintes.