Fingerprint est une protection anti-fraude disponible sur le nouveau widget de checkout. Elle nécessite une empreinte générée par fingerprint.com juste avant le chargement du widget de paiement. Les informations recueillies auprès du client à cette étape nous aident à identifier la fraude et à la refuser discrètement.
Intégrer Fingerprint
Pour intégrer Fingerprint, les étapes suivantes sont nécessaires :
[Côté client] Charger le script JS de fingerprint, idéalement de manière globale, sur toutes les pages.
[Côté client] Appeler fp.get() avec le fingerprintLinkedId de l'objet commande retourné dans l'API OCTO.
[Fingerprint] Une empreinte est générée en interne et envoyée à Ventrata via webhook.
[Backend] Interroger la requête GET /orders/:id jusqu'à ce que cardPayments.gateway ne soit plus nul.
[Backend] Lorsque l'étape 4 réussit, charger le formulaire de paiement avec la session de paiement par carte.
[Backend] Confirmer le paiement normalement.
📝 NOTES
Script JS Fingerprint
Nous utilisons fingerprintjs-pro. Lisez le Guide de démarrage rapide pour plus d'informations.
Vous devez simplement inclure le fichier JavaScript. Ensuite, chargez-le avec le script suivant :
const fp = FingerprintJS.load({
apiKey: "XXXXXXXX",
endpoint: "https://fp.ventrata.com",
scriptUrlPattern: "https://fp.ventrata.com/web/v<version>/<apiKey>/loader_v<loaderVersion>.js",
});La valeur
XXXXXXXXest votre clé API publique. Pour obtenir votre clé API, veuillez contacter votre responsable de compte.
Utilisez la fonctionnalité ventrata/checkout
Pour accéder à order.fingerprintLinkedId, ce qui sera nécessaire pour la suite, utilisez la ventrata/checkout fonctionnalité dans toutes les requêtes API que vous effectuez. Cela permettra :
Rendre
cardPayments.gatewaynul jusqu'à ce que nous recevions un webhook de Fingerprint.Fournir la valeur
order.fingerprintLinkedId.
Si vous avez des questions, n'hésitez pas à contacter l'équipe Ventrata.