Démarrage rapide

Vous codez avec un agent IA ? Collez-lui le prompt d’intégration : il contient tout ce qu’il faut pour faire ce guide à votre place.

Ouvrez votre compte

VerifNer est en bêta sur invitation. Suivez votre lien d’invitation, renseignez votre entreprise et le responsable du compte, puis connectez-vous à la console avec le lien reçu par e-mail.Pas encore d’invitation ? Écrivez-nous à contact@verifner.com.

Créez une clé de test

Console → Clés API → Nouvelle clé, mode Test. Elle commence par vn_test_ et ne s’affiche qu’une fois.

export VERIFNER_API_KEY=vn_test_...

Une clé de test fait tourner exactement le même traitement qu’une clé live, sans conserver d’image et sans être facturée.

Lancez une vérification

Choisissez selon votre cas :

A. Parcours hébergé (recommandé)
B. API directe

La personne prend elle-même ses photos, guidée par VerifNer. Votre serveur ouvre une session :

curl https://api.verifner.com/v1/sessions \
  -H "Authorization: Bearer $VERIFNER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reference": "client-4821"}'

Puis votre page monte le SDK web avec l’id et le client_token reçus :

<div id="kyc"></div>
<script src="https://cdn.jsdelivr.net/npm/@verifner/web@0.1/dist/verifner.iife.js"></script>
<script>
  VerifNer.create({
    sessionId: 'ses_…',
    clientToken: 'vn_ct_…',
    apiUrl: 'https://api.verifner.com',
  }).mount(document.getElementById('kyc'));
</script>

Guide complet : SDK web. Pour tester sans rien intégrer, lancez une session QR depuis la console.

Vous avez déjà les photos. Envoyez-les depuis votre serveur :

curl https://api.verifner.com/v1/verify \
  -H "Authorization: Bearer $VERIFNER_API_KEY" \
  -H "Idempotency-Key: client-4821-1" \
  -F front=@recto.jpg \
  -F back=@verso.jpg \
  -F selfie=@selfie.jpg

import fs from 'node:fs';

const form = new FormData();
for (const [field, file] of [['front', 'recto.jpg'], ['back', 'verso.jpg'], ['selfie', 'selfie.jpg']]) {
  form.append(field, new Blob([fs.readFileSync(file)]), file);
}
const res = await fetch('https://api.verifner.com/v1/verify', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.VERIFNER_API_KEY}`, 'Idempotency-Key': 'client-4821-1' },
  body: form,
});
const { verdict, score, checks } = await res.json();

import os, requests

with open("recto.jpg", "rb") as f, open("verso.jpg", "rb") as b, open("selfie.jpg", "rb") as s:
    res = requests.post(
        "https://api.verifner.com/v1/verify",
        headers={"Authorization": f"Bearer {os.environ['VERIFNER_API_KEY']}", "Idempotency-Key": "client-4821-1"},
        files={"front": f, "back": b, "selfie": s},
        timeout=60,
    )
result = res.json()

Pour un passeport, envoyez seulement la page d’identité dans front, sans back. Le verdict arrive dans la réponse, en général en 5 à 10 secondes.

Recevez le résultat

Déclarez un endpoint dans la console → Webhooks. À chaque verdict, VerifNer y envoie verification.completed, signé ; après une revue humaine, un second événement avec final_verdict. Pas besoin d’interroger l’API en boucle.

Verdict	Score	Action
`verified`	0,90 et plus	Poursuivre
`review`	0,60 à 0,89	Attendre la décision du relecteur
`rejected`	sous 0,60	Refuser ou demander un autre document

Voir Webhooks et Verdict et score.

Passez en live

Une fois l’accord pilote signé, nous activons le mode live sur votre organisation. Créez une clé vn_live_ et remplacez la clé de test : c’est tout. Les 50 premières vérifications live de chaque mois sont offertes.

Cas d’échec

401 unauthorized

Clé absente, mal copiée ou révoquée. Vérifiez l’en-tête Authorization: Bearer vn_….

422 unreadable

Photo trop floue pour être lue. Demandez une nouvelle photo : rien n’est enregistré ni facturé.

Le verdict est review

Normal pour un document limite : un relecteur tranche dans la console, et vous recevez un second webhook. Les justifications des contrôles disent ce qui a coûté des points.

Délai dépassé côté client

Une vérification peut prendre jusqu’à une dizaine de secondes. Réglez votre client HTTP à 60 secondes et réessayez avec la même Idempotency-Key : vous ne paierez pas deux fois.

Tous les codes : Erreurs.

Besoin d’aide ?

E-mail

contact@verifner.com

Référence API

Tous les endpoints, avec essai en direct.

Démarrer

Vérification

Intégration

Console

Référence

Démarrage rapide

Cas d’échec

Besoin d’aide ?

E-mail

Référence API

​Cas d’échec

​Besoin d’aide ?

E-mail

Référence API

Cas d’échec

Besoin d’aide ?