> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Vérification d'identité avec Zapier

> Automatisez la vérification d'identité avec l'app Zapier de Didit. Déclenchez des vérifications dans 6,000+ apps. Tarification à l'usage.

Connectez Didit à **6,000+ applications** grâce à Zapier, sans écrire de code. Créez automatiquement des sessions de vérification, réagissez aux changements de statut et synchronisez les résultats avec votre CRM, votre base de données ou vos outils de communication.

> [card] [Ouvrir Didit sur Zapier](https://zapier.com/apps/didit/integrations)
>
> Parcourez les déclencheurs, les actions et les modèles prêts à l'emploi sur la marketplace Zapier.

[Intégration Didit Zapier](https://www.youtube.com/embed/D7X4kNHxX0A?rel=0\&playsinline=1)

***

## Ce que vous obtenez

> [card] Créer des sessions
>
> Lancez des sessions de vérification à partir de soumissions de formulaires, d'événements CRM ou de toute application connectée à Zapier.

> [card] Webhooks en temps réel
>
> Recevez instantanément les mises à jour de statut (Approved, Declined, In Review, etc.) sous forme de déclencheurs Zapier.

> [card] Récupérer les résultats
>
> Récupérez à la demande le détail complet des sessions : données d'identité, scores de détection du vivant, correspondances AML.

***

## Prérequis

| Exigence | Où l'obtenir |
| - | - |
| **Compte Didit** | Inscrivez-vous sur [business.didit.me](https://business.didit.me). Le forfait KYC gratuit suffit pour tester. |
| **Clé API** | Console → **API & Webhooks** → copiez la clé de production. L'application Zapier s'authentifie avec cette clé pour chaque action. |
| **ID du workflow** | Console → **Workflows** → choisissez le workflow à lancer (ou [créez-en un](https://docs.didit.me/fr/console/workflows.md)). |
| **Compte Zapier** | Gratuit ou payant : [zapier.com](https://zapier.com). Le forfait gratuit gère 100 tâches par mois, suffisant pour de petits pilotes. |

***

## Fonctionnement

**1. Connecter Didit à Zapier**

Dans Zapier, recherchez **Didit** dans le répertoire d'applications (ou ouvrez directement la [fiche de la marketplace](https://zapier.com/apps/didit/integrations)) et connectez votre compte à l'aide de la **Clé API** disponible dans Console → **API & Webhooks**.

> [!TIP]
>
> Votre Clé API authentifie toutes les actions Didit dans Zapier. Vous n'avez besoin de vous connecter qu'une seule fois : tous vos Zaps partagent la même connexion, et la rotation de la clé dans la Console invalide la connexion Zapier jusqu'à ce que vous vous reconnectiez.

**2. Configurer un déclencheur**

Choisissez ce qui lance votre Zap. Il peut s'agir d'un **déclencheur Didit** ou de toute autre application :

| Source du déclencheur | Exemple |
| - | - |
| **Webhook Didit** | Le statut de la session passe à "Approved" |
| **Google Forms** | Nouvel envoi de formulaire → créer une session de vérification |
| **HubSpot** | Nouveau contact créé → déclencher un KYC |
| **Stripe** | Nouveau client → vérifier l'identité avant le versement |
| **Typeform** | Formulaire d'onboarding rempli → lancer la vérification |

**3. Ajouter une action Didit**

Utilisez l'une des actions Didit disponibles (les noms correspondent à la [fiche Zapier de la marketplace](https://zapier.com/apps/didit/integrations)) :

**Create Verification Session** : encapsule `POST /v3/session/`

* Indiquez l'**ID du workflow** de vérification à exécuter.
* Vous pouvez éventuellement définir une **URL de rappel** pour la redirection après la vérification.
* Transmettez des **Données du fournisseur** (par exemple l'e-mail de l'utilisateur ou votre identifiant interne) pour rattacher la session à vos enregistrements.
* L'action renvoie le nouveau `session_id`, l'`url` destinée à l'utilisateur et le `status` initial : utilisez l'`url` pour envoyer l'utilisateur vers le workflow de vérification.

**Retrieve Verification Session** : encapsule `GET /v3/session/{sessionId}/decision/`

* Transmettez un `session_id` pour récupérer le résultat complet de la vérification.
* Accédez aux données d'identité, aux scores de détection du vivant, aux résultats AML, au `status` final et aux URL des médias téléversés.

**4. Réagir aux résultats**

Ajoutez des actions en aval selon le résultat de la vérification :

| Statut | Action suggérée |
| - | - |
| `"Approved"` | Mettre à jour le CRM, accorder l'accès à la plateforme, envoyer un e-mail de bienvenue |
| `"Declined"` | Signaler dans la base de données, notifier la conformité, envoyer un e-mail de refus |
| `"In Review"` | Créer une tâche pour l'équipe de conformité, envoyer une notification Slack |
| `"Abandoned"` | Envoyer un e-mail de relance avec un nouveau lien de vérification |

![Création d'une session de vérification d'identité Didit depuis une étape d'action Zapier](https://mintcdn.com/didit-0f962782/DSfxHq_ggIpqiQSG/images/zapier-create-session.png?fit=max\&auto=format\&n=DSfxHq_ggIpqiQSG\&q=85\&s=f847a30aa1e0b600543ae4dec6229cdd)

Création d'une session de vérification Didit depuis une action Zapier.

***

## Modèles Zap populaires

> [card] Google Forms → Didit → Gmail
>
> L'utilisateur remplit le formulaire d'onboarding → session de vérification créée → résultat envoyé par e-mail à l'utilisateur et à l'administrateur.

> [card] HubSpot → Didit → HubSpot
>
> Nouveau contact → déclencher un KYC → mettre à jour les propriétés du contact avec le statut de vérification et les données d'identité.

> [card] Stripe → Didit → Slack
>
> Nouveau client → vérifier l'identité → notifier votre équipe sur Slack avec le résultat.

> [card] Webhook → Didit → Airtable
>
> Déclencheur personnalisé → vérifier l'utilisateur → consigner les résultats de session dans Airtable pour les registres de conformité.

***

## Déclencheurs et actions disponibles

Les noms ci-dessous correspondent à l'application Didit pour Zapier actuelle sur la [marketplace](https://zapier.com/apps/didit/integrations). Si vous voyez un libellé légèrement différent dans Zapier, fiez-vous à l'interface Zapier : le comportement sous-jacent reste le même.

### Déclencheurs (lancent un Zap)

| Déclencheur | Événement sous-jacent | Description |
| - | - | - |
| **Session Status Updated** | [webhook `status.updated`](https://docs.didit.me/fr/integration/webhooks) | Déclenché à chaque changement de statut d'une session de vérification (`Approved`, `Declined`, `In Review`, `Resubmitted`, `Abandoned`, `Kyc Expired`, etc.). |

### Actions (effectuent une opération)

| Action | Endpoint sous-jacent | Description |
| - | - | - |
| **Create Verification Session** | `POST /v3/session/` | Démarre une nouvelle session avec votre workflow, une URL de rappel facultative et `vendor_data`. Renvoie l'URL de la session à partager avec l'utilisateur. |
| **Retrieve Verification Session** | `GET /v3/session/{sessionId}/decision/` | Récupère le payload complet de la décision (données d'identité, détection du vivant, correspondances AML et statut final) pour un `session_id` donné. |

***

## Points à connaître

> [!WARNING]
>
> L'application Zapier de Didit se concentre volontairement sur la surface d'automatisation la plus utile : le lancement de sessions et la réaction aux mises à jour de statut. Les éléments suivants ne sont **pas** actuellement exposés via Zapier et nécessitent un appel direct à l'API :
>
> * Le téléversement d'une image de document, d'une vidéo ou d'un justificatif de domicile (POA) depuis une étape de Zap.
> * Les remplacements de décision via [`PATCH /v3/session/{sessionId}/update-status/`](https://docs.didit.me/fr/sessions-api/update-status).
> * Les endpoints spécifiques au KYB (registres des sociétés, personnes clés).
> * Les types d'événements webhook autres que les changements de statut au niveau de la session (par exemple `transaction.status.updated`, `user.status.updated`).
>
> Si vous avez besoin de l'un de ces éléments depuis un outil sans code, passez par l'[API Sessions](https://docs.didit.me/fr/sessions-api/create-session.md) via une étape **Webhooks by Zapier** avec votre clé API.

***

## Conseils et bonnes pratiques

> [accordion] Utiliser les Données du vendeur pour lier les sessions
>
> Transmettez toujours un identifiant unique (e-mail, ID utilisateur ou UUID) dans le champ **Données du vendeur** lors de la création des sessions. Cela vous permet de faire correspondre les résultats de vérification à l'utilisateur concerné dans votre système.

> [accordion] Gérer tous les statuts
>
> Créez des chemins dans votre Zap (à l'aide de la fonctionnalité Paths de Zapier) pour traiter différemment chaque statut : Approuvé, Refusé, En cours d'examen, Resoumis, Abandonné et Expiré méritent chacun une réponse adaptée.

> [accordion] Utiliser les filtres pour réduire le bruit
>
> Ajoutez des filtres Zapier pour ne déclencher les actions en aval que pour certains statuts. Par exemple, n'envoyez un e-mail de bienvenue que lorsque le statut est `"Approved"`.

> [accordion] Tester avant la mise en production
>
> Utilisez la fonctionnalité de test de Zapier ainsi que le bouton **Try Webhook** (dans Console → API & Webhooks) pour valider votre Zap de bout en bout avant de traiter de vrais utilisateurs.

***

## Étapes suivantes

> [card] [Guide de démarrage rapide](https://docs.didit.me/fr/getting-started/quick-start.md)
>
> Créez votre compte Didit, configurez un workflow et obtenez votre clé API.

> [card] [Webhooks](https://docs.didit.me/fr/integration/webhooks.md)
>
> Découvrez les payloads des webhooks et la vérification des signatures pour les intégrations côté serveur.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.