Passer au contenu principal

​
Apercu

Le flux de verification de TXCloud est concu pour etre flexible, prenant en charge les patterns de verification synchrones (instantanes) et asynchrones (bases sur des sessions).

​
Methodes de Verification

Verification Instantanee

Un seul appel API avec toutes les images. Ideal pour les integrations cote serveur.

Basee sur Session

Flux de telechargement en plusieurs etapes. Ideal pour les apps mobiles et les frontends web.

​
Flux de Verification Instantanee

Utilisez ceci lorsque vous avez tous les documents prets a soumettre en une fois : 
const verification = await txcloud.identity.verify({
  document_front: documentFrontBase64,
  document_back: documentBackBase64,  // optionnel
  selfie: selfieBase64,
  country: 'MA',
  document_type: 'national_id',
  checks: ['ocr', 'face_match', 'liveness', 'fraud']
});

​
Flux Base sur Session

Utilisez ceci pour les apps mobiles ou les utilisateurs capturent les documents etape par etape :

​
Etape 1 : Creer une Session

const session = await txcloud.identity.sessions.create({
  country: 'MA',
  document_type: 'national_id',
  checks: ['ocr', 'face_match', 'liveness'],
  webhook_url: 'https://votreapp.com/webhooks'
});

// Retourne session_id et URLs de telechargement
console.log(session.id); // 'sess_a1b2c3d4'

​
Etape 2 : Telecharger les Documents

// Telecharger le recto du document
await txcloud.identity.sessions.uploadDocument(session.id, {
  type: 'document_front',
  image: documentFrontBase64
});

// Telecharger le verso du document (si requis)
await txcloud.identity.sessions.uploadDocument(session.id, {
  type: 'document_back',
  image: documentBackBase64
});

// Telecharger le selfie
await txcloud.identity.sessions.uploadDocument(session.id, {
  type: 'selfie',
  image: selfieBase64
});

​
Etape 3 : Completer la Session

const verification = await txcloud.identity.sessions.complete(session.id);

// Pour le traitement async, ecoutez le webhook
// ou interrogez le statut de verification

​
Controles de Verification

Chaque verification peut inclure plusieurs controles :
ControleDescriptionTemps
ocrExtraire le texte du document~1s
face_matchComparer le selfie a la photo du document~1s
livenessDetecter si le selfie est d’une personne vivante~1s
fraudVerifier la falsification du document~2s
data_validationValider les formats des donnees extraites~0.5s
age_verificationVerifier que l’utilisateur a l’age minimum~0.5s
N’incluez que les controles dont vous avez besoin - moins de controles = traitement plus rapide.

​
Statuts de Verification

StatutDescriptionFinal ?
pendingTraitement en coursNon
verifiedTous les controles passesOui
failedUn ou plusieurs controles echouesOui
expiredSession expiree avant completionOui
cancelledVerification annuleeOui
manual_reviewNecessite une revision humaineNon

​
Gerer les Resultats

const verification = await txcloud.identity.verifications.get(verificationId);

switch (verification.status) {
  case 'verified':
    // Utilisateur verifie - procedez a l'onboarding
    await onboardUser(verification.extracted_data);
    break;

  case 'failed':
    // Verification echouee - verifiez les raisons
    const failures = verification.checks
      .filter(c => c.status === 'failed');
    await handleFailure(failures);
    break;

  case 'manual_review':
    // Necessite une revision humaine
    await queueForReview(verification.id);
    break;
}

​
Bonnes Pratiques

Verifiez la qualite de l’image cote client :
  • Resolution minimum : 1280x720
  • Taille du fichier : Moins de 10MB
  • Format : JPEG ou PNG
  • Pas de flou ou de reflets
N’interrogez pas - utilisez les webhooks pour des mises a jour en temps reel sur la verification basee sur session.
Implementez des gestionnaires pour chaque statut possible, y compris les cas limites comme expired.
Stockez toujours l’ID de verification pour reference future et pistes d’audit.

​
Prochaines Etapes

Reference API Identity

Explorez tous les endpoints Identity

Guide Detection de Fraude

Ajoutez la detection de fraude a votre flux