Vérifier les pièces d'identité de vos utilisateurs

Installer le SDK Client-side

Le SDK iOS de Stripe est disponible en open source et fait l’objet d’une documentation complète. Il est également compatible avec les applications prenant en charge iOS 13.0 et les versions ultérieures.

Configurer l’autorisation d’accès à l’appareil photo Client-side

Le SDK iOS de Stripe Identity doit pouvoir accéder à l’appareil photo de l’appareil pour capturer des pièces d’identité. Pour permettre à votre application de demander des autorisations d’accès à l’appareil photo :

1. Ouvrez le fichier Info.plist de votre projet dans Xcode.
2. Ajoutez la clé NSCameraUsageDescription.
3. Ajoutez une valeur de chaîne qui explique à vos utilisateurs pourquoi votre application nécessite des autorisations de caméra, par exemple :

Cette application utilise l’appareil photo pour prendre une photo de vos documents d’identité.

Consultez la documentation d’Apple pour en savoir plus sur la demande d’accès à l’appareil photo.

Installer Stripe sur votre serveur Server-side

Pour commencer, créez un compte Stripe.

Installez ensuite les bibliothèques permettant d’accéder à l’API Stripe depuis votre application :

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Créer une VerificationSession

Une VerificationSession est une représentation programmatique de la vérification. Elle contient des détails concernant le type de vérification, comme les contrôles à effectuer. Vous pouvez développer le champ des résultats vérifiés pour afficher les données qui ont été contrôlées.

Vous avez besoin d’un endpoint côté serveur pour créer la VerificationSession. La création de la VerificationSession côté serveur éliminera tout risque de remplacement des options de vérification par des utilisateurs malintentionnés et vous évitera ainsi des frais de traitement sur votre compte. Ajoutez une authentification à cet endpoint en incluant une référence utilisateur dans les métadonnées de la session ou en enregistrant l’ID de session dans votre base de données.

Pour des raisons de sécurité, ne créez pas d’objet VerificationSession directement accessible depuis le client mobile. Le SDK recevra en fait de la part de votre serveur une clé éphémère d’accès, à savoir une clé API temporaire lui octroyant un droit d’accès restreint à l’objet VerificationSession. Cette clé éphémère lui ouvrira en quelque sorte une session, durant laquelle le SDK sera autorisé à récupérer et mettre à jour l’objet VerificationSession.

Une fois votre VerificationSession et votre clé éphémère créées, envoyez l’ID de la VerificationSession et la clé secrète éphémère au client pour afficher la feuille de chargement de documents.

// 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');

// In the route handler for /create-verification-session:
// Authenticate your user.

// Create the session.
const verificationSession = await stripe.identity.verificationSessions.create({
  type: 'document',
  provided_details: {
    email: 'user@example.com',
  },
  metadata: {
    user_id: '{{USER_ID}}',
  },
});

// Create an ephemeral key for the VerificationSession
const ephemeralKey = await stripe.ephemeralKeys.create(
  {verification_session: verificationSession.id},
  {apiVersion: '2025-07-30.basil'}
);

// Return only the ID and ephemeral key secret to the frontend.
const verficationSessionId = verificationSession.id;
const ephemeralKeySecret = ephemeralKey.secret;

Testez votre endpoint en démarrant votre serveur Web (par exemple, localhost:4242) et en envoyant une requête POST avec curl pour créer une VerificationSession :

curl -X POST -is "http://localhost:4242/create-verification-session" -d ""

La réponse doit ressembler à ceci sur votre terminal :

HTTP/1.1 200 OK
Content-Type: application/json

{ id: "vs_QdfQQ6xfGNJR7ogV6", ephemeral_key_secret: "ek_YWNjdF8xRm..." }

Paramétrez un bouton afin qu’il feuille de chargement de document. En touchant le bouton, vos utilisateurs pourront capturer et charger une photo de leur passeport, de leur permis de conduire ou de leur carte d’identité.

Avant de démarrer, votre page de vérification doit :

• Expliquer à l’utilisateur pourquoi son identité doit être vérifiée.
• Inclure un bouton de vérification d’identité pour afficher l’interface utilisateur de Stripe.

Ajouter un bouton

Commencez par créer un contrôleur d’affichage avec un bouton cliquable qui dispose d’un indicateur de chargement :

import UIKit

class VerifyViewController: UIViewController {
  @IBOutlet weak var verifyButton: UIButton!
  @IBOutlet weak var activityIndicator: UIActivityIndicatorView!
}

Importer le SDK StripeIdentity

Importez StripeIdentity sur votre contrôleur d’affichage :

import UIKit
import StripeIdentity

class VerifyViewController: UIViewController {
  @IBOutlet weak var verifyButton: UIButton!
  @IBOutlet weak var activityIndicator: UIActivityIndicatorView!
}

Ajouter une action au bouton de vérification

Maintenant que vous avez un bouton et un endpoint pour créer une VerificationSession, modifiez le bouton afin que son activation déclenche l’affichage de la feuille de chargement de documents.

Ajoutez un appel pour :

• Récupérez l’ID VerificationSession et la clé secrète éphémère depuis votre endpoint.
• Instanciez une IdentityVerificationSheet avec le logo de votre marque et affichez-la à l’utilisateur.
• Gérez le VerificationResult afin de savoir si l’utilisateur a exécuté le flux de vérification.

import UIKit
import StripeIdentity

class VerifyViewController: UIViewController {
  @IBOutlet weak var verifyButton: UIButton!
  @IBOutlet weak var activityIndicator: UIActivityIndicatorView!

  override func viewDidLoad() {
    super.viewDidLoad()

    verifyButton.addTarget(self, action: #selector(didTapVerifyButton), for: .touchUpInside)
  }

  @objc
  func didTapVerifyButton() {
    // Disable the button while the request is made
    verifyButton.isEnabled = false
    activityIndicator.startAnimating()

    // Make request to your verification endpoint
    var urlRequest = URLRequest(url: URL(string: "https://{{YOUR_SERVER_BASE_URL}}/create-verification-session")!)
    urlRequest.httpMethod = "POST"

    let task = URLSession.shared.dataTask(with: urlRequest) { [weak self] data, response, error in
      DispatchQueue.main.async { [weak self] in
        // Re-enable button
        self?.verifyButton.isEnabled = true
        self?.activityIndicator.stopAnimating()

        guard error == nil,
              let data = data,
              let responseJson = try? JSONDecoder().decode([String: String].self, from: data),
              let verificationSessionId = responseJson["id"],
              let ephemeralKeySecret = responseJson["ephemeral_key_secret"] else {
          // Handle error
          print(error as Any)
          return
        }

        self?.presentVerificationSheet(verificationSessionId: verificationSessionId, ephemeralKeySecret: ephemeralKeySecret)
      }
    }
    task.resume()
  }

  func presentVerificationSheet(verificationSessionId: String, ephemeralKeySecret: String) {
    // Configure a square brand logo. Recommended image size is 32 x 32 points.
    let configuration = IdentityVerificationSheet.Configuration(
        brandLogo: UIImage(named: "{{YOUR_BRAND_LOGO}}")!
    )
    // Instantiate and present the sheet
    let verificationSheet = IdentityVerificationSheet(
      verificationSessionId: verificationSessionId,
      ephemeralKeySecret: ephemeralKeySecret,
      configuration: configuration
    )
    verificationSheet.present(from: self, completion: { result in
      switch result {
      case .flowCompleted:
        // The user has completed uploading their documents.
        // Let them know that the verification is processing.
        print("Verification Completed!")
      case .flowCanceled:
        // The user did not complete uploading their documents.
        // You should allow them to try again.
        print("Verification Canceled!")
      case .flowFailed(let error):
        // If the flow fails, you should display the localized error
        // message to your user using error.localizedDescription
        print("Verification Failed!")
        print(error.localizedDescription)
      }
    })
  }
}

Tester la feuille de vérification

Vérifiez que le bouton de vérification affiche la feuille de chargement de documents :

• Touchez le bouton Vérifier l’identité.
• Vérifiez qu’aucun message d’erreur ne s’affiche.

Si votre intégration ne fonctionne pas :

1. Fixez un point d’arrêt à l’endroit où vous récupérez l’ID VerificationSession et la clé secrète éphémère.
2. Vérifiez qu’il n’existe aucune erreur réseau et que l’endpoint renvoie un ID VerificationSession et une clé secrète éphémère.

Document checks are typically completed as soon as the user redirects back to your site and you can retrieve the result from the API immediately. In some rare cases, the document verification isn’t ready yet and must continue asynchronously. In these cases, you’re notified through webhooks when the verification result is ready. After the processing completes, the VerificationSession status changes from processing to verified.

Stripe envoie les événements suivants lorsque l’état de la session change :

Utilisez un gestionnaire de webhook pour recevoir ces événements et automatiser des actions telles que l’envoi d’un e-mail de confirmation, la mise à jour des résultats de la vérification dans votre base de données ou l’exécution d’une étape d’inscription. Vous pouvez également consulter les événements de vérification dans votre Dashboard.

Recevoir des événements et exécuter des actions métier

Avec code

Créez un gestionnaire de webhook pour écouter les événements et créer des flux de vérification asynchrones personnalisés. Testez et déboguez votre intégration de webhook en local avec la CLI Stripe.

Créer un webhook personnalisé

Sans code

Utilisez le Dashboard pour consulter toutes vos vérifications, inspecter les données collectées et comprendre les échecs de vérification.

Afficher vos vérifications de test dans le Dashboard