Aller au contenu

Quickstart : premier lien KYC en 10 minutes

À la fin de ce guide, vous aurez créé un lien de vérification, fait le parcours sur votre téléphone et reçu la décision sur votre serveur.

  1. Créez la session.

    Fenêtre de terminal
    curl -X POST "https://api.regulalink.pro/v1/kyc/sessions" \
    -H "Authorization: Bearer $REGULALINK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
    "formCode": "kyc-client-wallet",
    "externalRef": "client-2929292",
    "redirectUrl": "https://votre-app.com/kyc/retour",
    "webhookUrl": "https://votre-app.com/webhooks/regulalink",
    "prefill": { "first_name": "Donatien", "last_name": "Kanyinda" },
    "locale": "fr"
    }'

    La réponse (201 Created) contient l’URL du parcours et le secret de signature :

    {
    "status": "success",
    "message": "Session créée",
    "data": {
    "id": "7c1e…",
    "url": "https://kyc.votre-domaine.com/v/Qk3…",
    "status": "CREATED",
    "externalRef": "client-2929292",
    "expiresAt": "2026-10-24T10:05:00.000+00:00",
    "signingSecret": "kycsec_…"
    }
    }
  2. Enregistrez id et signingSecret dans votre base, liés à votre client. Le secret sert à vérifier le webhook et la redirection ; il n’est renvoyé qu’à la création.

  3. Ouvrez data.url sur votre téléphone. Le parcours guide la personne : pièce, lecture automatique, selfie, récapitulatif. Sur ordinateur, un QR code permet de continuer sur le téléphone.

  4. Recevez le résultat. Deux événements arrivent sur webhookUrl :

    • kyc.session.completed dès l’envoi du parcours ;
    • kyc.session.decided quand la décision est prise (automatiquement ou par un agent).

    Vérifiez la signature avant de traiter l’événement : Webhooks et signature.

  5. Ramenez la personne dans votre app. Si vous avez fourni redirectUrl, elle y est renvoyée avec des paramètres signés (status, decision, signature…).