Flux de Verification

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']
});

verification = txcloud.identity.verify(
    document_front=document_front_base64,
    document_back=document_back_base64,
    selfie=selfie_base64,
    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 :

Controle	Description	Temps
`ocr`	Extraire le texte du document	~1s
`face_match`	Comparer le selfie a la photo du document	~1s
`liveness`	Detecter si le selfie est d’une personne vivante	~1s
`fraud`	Verifier la falsification du document	~2s
`data_validation`	Valider les formats des donnees extraites	~0.5s
`age_verification`	Verifier 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

Statut	Description	Final ?
`pending`	Traitement en cours	Non
`verified`	Tous les controles passes	Oui
`failed`	Un ou plusieurs controles echoues	Oui
`expired`	Session expiree avant completion	Oui
`cancelled`	Verification annulee	Oui
`manual_review`	Necessite une revision humaine	Non

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;
}

verification = txcloud.identity.verifications.get(verification_id)

if verification.status == "verified":
    # Utilisateur verifie
    onboard_user(verification.extracted_data)
elif verification.status == "failed":
    # Verification echouee
    failures = [c for c in verification.checks if c.status == "failed"]
    handle_failure(failures)
elif verification.status == "manual_review":
    # Necessite une revision humaine
    queue_for_review(verification.id)

Bonnes Pratiques

Validez les Images Avant le Telechargement

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

Utilisez les Webhooks pour l'Async

N’interrogez pas - utilisez les webhooks pour des mises a jour en temps reel sur la verification basee sur session.

Gerez Tous les Statuts

Implementez des gestionnaires pour chaque statut possible, y compris les cas limites comme expired.

Stockez les IDs de Verification

Stockez toujours l’ID de verification pour reference future et pistes d’audit.

Demarrage

Concepts Cles

Guides

SDKs

Ressources

Flux de Verification

Apercu

Methodes de Verification

Verification Instantanee

Basee sur Session

Flux de Verification Instantanee

Flux Base sur Session

Etape 1 : Creer une Session

Etape 2 : Telecharger les Documents

Etape 3 : Completer la Session

Controles de Verification

Statuts de Verification

Gerer les Resultats

Bonnes Pratiques

Prochaines Etapes

Reference API Identity

Guide Detection de Fraude

​Apercu

​Methodes de Verification

Verification Instantanee

Basee sur Session

​Flux de Verification Instantanee

​Flux Base sur Session

​Etape 1 : Creer une Session

​Etape 2 : Telecharger les Documents

​Etape 3 : Completer la Session

​Controles de Verification

​Statuts de Verification

​Gerer les Resultats

​Bonnes Pratiques

​Prochaines Etapes

Reference API Identity

Guide Detection de Fraude

Apercu

Methodes de Verification

Flux de Verification Instantanee

Flux Base sur Session

Etape 1 : Creer une Session

Etape 2 : Telecharger les Documents

Etape 3 : Completer la Session

Controles de Verification

Statuts de Verification

Gerer les Resultats

Bonnes Pratiques

Prochaines Etapes