Contrôles de vérification

Si les vérifications de document offrent un moyen de défense contre l’utilisation de pièces d’identité frauduleuses, il n’est pas exclu que les fraudeurs aient accès à des documents authentiques dérobés. Pour y remédier, Stripe Identity peut vérifier l’identité des utilisateurs au moyen de selfies.

Les vérifications de selfie recherchent des traits biologiques distinctifs, tels que la géométrie du visage, à partir d’une photo d’identité et d’un portrait de l’utilisateur. Stripe utilise alors des algorithmes avancés de machine learning pour vérifier que les photos du visage appartiennent à une seule et même personne.

Dans certaines régions, notamment l’UE, il existe des lois en matière de confidentialité en vertu desquelles vous devez justifier votre utilisation de technologies biométriques ou proposer des moyens de vérification alternatifs. Nous vous recommandons de proposer une option de vérification alternative ou de demander conseil auprès de votre conseiller juridique.

Disponibilité

Les vérifications de selfie sont disponibles pour les photos d’identité officielles prises dans les pays suivants :

Ajout de vérifications à l’aide de selfies

Pour ajouter des vérifications de selfie à votre application, veuillez d’abord consulter le guide pour savoir comment collecter et vérifier des pièces d’identité.

Ajout de vérifications de selfie à des VerificationSessions

Lors la création d’une VerificationSession, utilisez le paramètre options.document.require_matching_selfie pour activer les vérifications de selfie.

curl https://api.stripe.com/v1/identity/verification_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=document \
  -d "options[document][require_matching_selfie]"=true

Le flux de vérification est alors configuré pour exiger une pièce d’identité avec photo et une photo du visage de l’utilisateur.

Accès aux résultats des vérifications de selfie

Une fois soumis et traité, le statut de la VerificationSession change en fonction du résultat des contrôles :

• verified - La vérification du document et du selfie a réussi. La session verified_outputs contient des informations extraites du document.
• requires_input - La vérification de la pièce d’identité ou du selfie a échoué.

Pour accéder à la photo capturée du selfie et de la pièce d’identité, vous devez extraire le VerificationReport associé. Pour cela, vous devez développer le champ last_verification_report dans la session :

// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')(
'sk_test_BQokikJOvBiI2HlWgH4olfQ2');
const verificationSession = await stripe.identity.verificationSessions.retrieve(
  '{{SESSION_ID}}',
  {
    expand: ['last_verification_report'],
  }
);
const verificationReport = verificationSession.last_verification_report;

Les champs document et selfie du VerificationReport contiennent les résultats de la vérification du document et du selfie. Voici un exemple de VerificationReport pour lequel le document et le selfie ont passé avec succès les vérifications :

{
  "id": "vr_80Xjv6GEU07D1e6pZn5lt0Za",
  "object": "identity.verification_report",
  "type": "document",
  "verification_session": "vs_KMs2DjnuOc8j38lfwnPDebNR",
  "created": 1611776872,
  "livemode": true,
  "options": {
    "document": {
      "require_matching_selfie": true
    }
  },
  "document": {
    "status": "verified",
    "error": null,
    "first_name": "Jenny",
    "last_name": "Rosen",
    "address": {
      "line1": "1234 Main St.",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94111",
      "country": "US"
    },
    "document_type": "id_card",
    "expiration_date": {
      "day": 17,
      "month": 7,
      "year": 2024
    },
    "files": ["file_hRTU1MLQuHKBNEBk3oGCIU72", "file_bxPiLyAUdermbHHmi4unkvw4"],
    "issued_date": {
      "day": 4,
      "month": 27,
      "year": 2021
    },
    "issuing_country": "US"
  },
  "selfie": {
    "status": "verified",
    "error": null,
    "document": "file_1LWstKFMO0UGZzOzNeCjM7DS",
    "selfie": "file_6z6PLFT7CKfkxFo7bv2zBZ06",
  }
}

Pour accéder aux images de documents et de visages collectées, voir Accès aux résultats de la vérification.

Comprendre l’échec des vérifications de selfie

Les champs document et selfie du VerificationReport contiennent les données collectées ainsi que les champs status et error qui permettent de déterminer si la vérification a réussi ou non.

Le champ status indique le succès ou l’échec de chaque vérification. Les valeurs possibles sont :

• verified - Le contrôle de vérification a réussi et les données collectées ont été vérifiées.
• unverified - Le contrôle de vérification a échoué. Vous pouvez consulter le hachage error pour de plus amples informations.

En cas d’échec de la vérification, le champ error contient les valeurs code et reason pour expliquer le motif de l’erreur. Le champ error.code peut être utilisé pour gérer de manière programmatique les échecs de vérification. Le champ reason contient un message descriptif expliquant la raison de l’échec et peut être présenté à l’utilisateur.

Échecs de vérification de document

Les détails de l’échec sont disponibles dans le champ document.error du rapport.

Échecs de vérification de selfie

Les détails de l’échec sont disponibles dans le champ selfie.error du rapport.