Skip to main content

Validations téléphoniques

Qu'est-ce qu'une validation téléphonique ?​

Une validation téléphonique (Phone Validation) est une session OTP pour un numéro de téléphone. Verifik envoie un code à usage unique par SMS ou WhatsApp, puis vous confirmez le code saisi par l'utilisateur.

Cycle de vie typique :

  1. Envoi — créer une Phone Validation et délivrer l'OTP
  2. Vérification — soumettre le même téléphone + OTP pour marquer la session comme validée

Voir la liste complète des champs dans L'objet Phone Validation.

Règles de temporisation​

RègleDéfaut
OTP valide pendant10 minutes (expiresAt dans la réponse d'envoi)
Délai de renvoi~2 minutes entre les envois pour le même téléphone + passerelle (409 otp_recently_sent)
Contournement du délaiCréation manuelle avec "force": true

Envoyez et affichez toujours le countryCode avec le phone national (ex. +57 3001234567) afin que les utilisateurs sachent quelle destination a reçu le message.

Choisissez votre chemin d'intégration​

Choisissez le chemin qui correspond à la façon dont vous appelez l'API.

Chemin A — Autonome / Smart Tools (sans projet)​

Utilisez ce chemin lorsque vous envoyez des OTP depuis votre backend ou depuis Smart Tools → WhatsApp / SMS Messages, sans projet Smart Enroll ou Smart Access.

ÉtapeEndpoint
1. Envoyer l'OTPPOST /v2/phone-validations/manual
2. Vérifier l'OTPPUT /v2/phone-validations
  • Aucun project / projectFlow requis
  • Le source de l'enregistrement est "manual"
  • Facturé avec des crédits de communication au compteur après un envoi réussi
  • Le title optionnel (max 15 caractères) définit le nom de l'entreprise dans le modèle WhatsApp/SMS
Your app                    Verifik API
────────                    ───────────
POST /manual  ───────────►  OTP sent (SMS / WhatsApp)
                            status: sent

PUT  /phone-validations ─►  OTP checked
  { phone, countryCode, otp }   status: validated

Chemin B — Projet / App Registration (Smart Enroll & Access)​

Utilisez ce chemin lorsque l'OTP fait partie d'un flux d'inscription ou de connexion lié à un projet.

ÉtapeEndpoint
1. Envoyer l'OTPPOST /v2/phone-validations/app-registration
2. Vérifier l'OTPPUT /v2/phone-validations
  • Nécessite un contexte projet / app registration
  • Le source de l'enregistrement vaut par défaut "flow"
  • La facturation peut utiliser les compteurs des plans Smart Enroll / Smart Access selon le flux

Index des endpoints API​

ActionMéthode et cheminDocs
Envoyer un OTP autonomePOST /v2/phone-validations/manualCréer une Phone Validation manuelle
Vérifier l'OTPPUT /v2/phone-validationsValider une Phone Validation
Envoyer un OTP en app registrationPOST /v2/phone-validations/app-registrationCréer une Phone Validation App Registration
ListerGET /v2/phone-validationsLister toutes les Phone Validations
Récupérer uneGET /v2/phone-validations/{id}Récupérer une Phone Validation
Tarifs SMS et WhatsApp—Tarifs SMS et WhatsApp
Authentification

Tous les endpoints exigent Authorization: Bearer {YOUR_ACCESS_TOKEN} et Content-Type: application/json.

Valeurs de statut​

StatutSignification
sentL'OTP a été délivré (ou accepté par le fournisseur)
validatedL'OTP utilisateur correspond
failedExpiré, rejeté, ou échec d'envoi
newCréé mais pas encore envoyé avec succès

Pages associées​