Erreurs, limites et mise en production
This content is not available in your language yet.
Format des réponses
Section intitulée « Format des réponses »Toutes les réponses suivent la même enveloppe :
{ "status": "success", "message": "Session créée", "data": { }, "metadata": null }{ "status": "error", "message": "formCode requis (code du formulaire KYC)", "data": null }Erreurs courantes
Section intitulée « Erreurs courantes »| HTTP | Message | Cause et correction |
|---|---|---|
| 401 / 403 | Clé API requise | En-tête Authorization: Bearer … ou X-Api-Key absent ou clé révoquée |
| 400 | formCode requis (code du formulaire KYC) | Ajoutez formCode |
| 400 | Formulaire introuvable : … | Vérifiez le code dans KYC → Formulaires KYC |
| 400 | Ce type n'a pas de formulaire configuré | Le formulaire existe mais n’a pas de schéma enregistré |
| 400 | redirectUrl doit être en https | Utilisez https:// ou un schéma d’application |
| 400 | redirectUrl : schéma interdit | javascript:, data:, file:… ne sont pas acceptés |
| 400 | webhookUrl refusée : … | URL non publique ou invalide |
| 400 | Session introuvable | id inconnu pour votre organisation |
| 404 | Lien de vérification invalide ou expiré | Côté parcours : lien expiré ou annulé, créez une nouvelle session |
| 400 | Nombre maximal de tentatives atteint | 3 envois au maximum par session |
| 400 | Image trop lourde (12 Mo max) | Fichier trop volumineux à l’envoi |
| Élément | Valeur |
|---|---|
| Validité d’un lien | 5 minutes à 7 jours (défaut 24 heures) |
| Tentatives par session | 3 |
| Taille d’une image envoyée | 12 Mo |
| Formats d’image | Images (image/*) et PDF |
| Délai de réponse webhook | 10 secondes |
| Reprises webhook | 2 (à 5 s puis 30 s) |
externalRef | 190 caractères |
Checklist de mise en production
Section intitulée « Checklist de mise en production »- Clé API de production créée, stockée dans un coffre, jamais dans l’application mobile
-
signingSecretenregistré pour chaque session créée - Webhook en HTTPS, signature vérifiée sur le corps brut, comparaison à temps constant
- Doublons ignorés grâce à
X-RegulaLink-Idempotency-Key - Accès ou plafonds accordés uniquement après
kyc.session.decidedvérifié -
redirectUrlen HTTPS ou schéma d’application ; signature ettsvérifiés au retour - Caméra autorisée dans la WebView (Android et iOS)
- Parcours testé de bout en bout : approbation, reprise de photo, refus, lien expiré