Aller au contenu

Erreurs, limites et mise en production

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 }
HTTPMessageCause et correction
401 / 403Clé API requiseEn-tête Authorization: Bearer … ou X-Api-Key absent ou clé révoquée
400formCode requis (code du formulaire KYC)Ajoutez formCode
400Formulaire introuvable : …Vérifiez le code dans KYC → Formulaires KYC
400Ce type n'a pas de formulaire configuréLe formulaire existe mais n’a pas de schéma enregistré
400redirectUrl doit être en httpsUtilisez https:// ou un schéma d’application
400redirectUrl : schéma interditjavascript:, data:, file:… ne sont pas acceptés
400webhookUrl refusée : …URL non publique ou invalide
400Session introuvableid inconnu pour votre organisation
404Lien de vérification invalide ou expiréCôté parcours : lien expiré ou annulé, créez une nouvelle session
400Nombre maximal de tentatives atteint3 envois au maximum par session
400Image trop lourde (12 Mo max)Fichier trop volumineux à l’envoi
ÉlémentValeur
Validité d’un lien5 minutes à 7 jours (défaut 24 heures)
Tentatives par session3
Taille d’une image envoyée12 Mo
Formats d’imageImages (image/*) et PDF
Délai de réponse webhook10 secondes
Reprises webhook2 (à 5 s puis 30 s)
externalRef190 caractères
  • Clé API de production créée, stockée dans un coffre, jamais dans l’application mobile
  • signingSecret enregistré 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.decided vérifié
  • redirectUrl en HTTPS ou schéma d’application ; signature et ts vé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é