Quickstart : premier lien KYC en 10 minutes
This content is not available in your language yet.
À 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.
-
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"}'const res = await fetch("https://api.regulalink.pro/v1/kyc/sessions", {method: "POST",headers: {Authorization: `Bearer ${process.env.REGULALINK_API_KEY}`,"Content-Type": "application/json",},body: JSON.stringify({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",}),});const { data } = await res.json();// Conservez data.id et data.signingSecret : le secret n'est renvoyé qu'une fois.import os, requestsr = requests.post("https://api.regulalink.pro/v1/kyc/sessions",headers={"Authorization": f"Bearer {os.environ['REGULALINK_API_KEY']}"},json={"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",},timeout=15,)data = r.json()["data"]$ch = curl_init("https://api.regulalink.pro/v1/kyc/sessions");curl_setopt_array($ch, [CURLOPT_POST => true,CURLOPT_RETURNTRANSFER => true,CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("REGULALINK_API_KEY"),"Content-Type: application/json",],CURLOPT_POSTFIELDS => json_encode(["formCode" => "kyc-client-wallet","externalRef" => "client-2929292","redirectUrl" => "https://votre-app.com/kyc/retour","webhookUrl" => "https://votre-app.com/webhooks/regulalink","locale" => "fr",]),]);$data = json_decode(curl_exec($ch), true)["data"];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_…"}} -
Enregistrez
idetsigningSecretdans votre base, liés à votre client. Le secret sert à vérifier le webhook et la redirection ; il n’est renvoyé qu’à la création. -
Ouvrez
data.urlsur 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. -
Recevez le résultat. Deux événements arrivent sur
webhookUrl:kyc.session.completeddès l’envoi du parcours ;kyc.session.decidedquand la décision est prise (automatiquement ou par un agent).
Vérifiez la signature avant de traiter l’événement : Webhooks et signature.
-
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…).
Et ensuite
Section intitulée « Et ensuite »- Testez un refus ou une reprise de photo pour voir les statuts
RETRYetREJECTED: Statuts et contrôles. - Intégrez le lien dans votre application mobile : Intégration mobile.
- Avant la mise en production, suivez la checklist.