Des codes à usage unique par texto pour les numéros canadiens

1. 1

   Lancer une vérification

   Appelez POST /v1/verify avec l’un de vos numéros comme from, le numéro de votre utilisateur comme to et, si vous le voulez, le nom de votre application. HonkIO envoie un code par texto et répond avec l’identifiant de la vérification.

2. 2

   Valider le code

   Envoyez le code saisi par votre utilisateur à POST /v1/verify/:id/check. Un bon code répond verified; un code erroné indique le nombre de tentatives restantes.

3. 3

   Utiliser le numéro confirmé

   Marquez le numéro comme confirmé dans votre application. GET /v1/verify/:id lit l’état d’une vérification en tout temps, et GET /v1/verify les énumère.

• Des codes de 4, 6 ou 8 chiffres, 6 par défaut.
• Les codes expirent après 10 minutes par défaut; choisissez de 1 à 60 minutes.
• Cinq codes erronés bloquent la vérification : impossible de deviner un code en les essayant tous.
• Un code par numéro de téléphone par minute : personne ne peut inonder un téléphone de textos par votre application.
• Les codes ne sont conservés que sous forme hachée, et le texto qui a porté un code n’est pas stocké.
• Le nom de votre application dans le message, accepté seulement en texte brut : il ne peut jamais contenir de lien.
• Un numéro qui vous a répondu STOP ne reçoit aucun texto, même pour un code.
• Des erreurs en français et en anglais, avec des codes stables comme VERIFICATION_EXPIRED et VERIFICATION_MAX_ATTEMPTS.

• 0,25 $par vérification
• 0,03 $par segment SMS pour le texto qui porte le code
• 2,50 $par mois pour un numéro local d’envoi

Un code tient en un segment, sauf si le nom de votre application est long ou utilise des caractères hors du jeu SMS standard. Une vérification refusée par l’opérateur est remboursée en entier, et les vérifications en mode test sont gratuites.

• HonkIO traite un code à usage unique comme un message transactionnel : il ne demande donc pas de consentement LCAP avant de l’envoyer. Il respecte quand même STOP : un numéro qui s’est retiré de vos textos ne reçoit aucun code tant qu’il ne s’est pas réinscrit.
• Les codes ne sont envoyés qu’à des numéros canadiens. Tout autre numéro est refusé avec NON_CANADIAN_NUMBER avant toute facturation.
• Les codes peuvent partir d’un numéro sans frais une fois celui-ci vérifié, et ils n’exigent pas le double consentement que demandent les autres textos sans frais.
• Avant votre premier code en production, vous confirmez votre propre numéro de téléphone, comme pour tout envoi en production.
• Les vérifications sont stockées au Canada (AWS ca-central-1, Montréal). Les requêtes sont traitées sur une infrastructure hébergée aux États-Unis avant d’être stockées, comme l’explique la politique de confidentialité.

Avec une clé de test (mk_test_...), rien n’est envoyé ni facturé. Le code est toujours composé de zéros (000000 pour six chiffres), et le numéro from peut être tout numéro canadien ou américain valide : vous pouvez donc bâtir tout le parcours avant de recharger votre solde ou d’acheter un numéro. Chaque vérification indique si elle était LIVE ou TEST.

Les SDK Node.js, Python, PHP et Laravel ont des méthodes Verify, l’API REST accepte du JSON simple, et le serveur MCP de HonkIO donne à un agent IA des outils pour lancer et valider des codes.

Verify peut-il envoyer les codes par courriel ou par appel vocal ?

Non. Verify envoie les codes par texto seulement, à des numéros de téléphone canadiens.

Faut-il un consentement LCAP avant d’envoyer un code ?

HonkIO traite un code à usage unique comme un message transactionnel et ne vérifie pas le consentement LCAP avant de l’envoyer. Il vérifie toutefois STOP : un numéro qui s’est retiré de vos textos ne reçoit aucun code tant qu’il ne s’est pas réinscrit. Les messages commerciaux que vous enverrez ensuite à ce numéro exigent toujours un consentement.

Combien coûte une vérification ?

0,25 $ par vérification, plus 0,03 $ par segment SMS pour le texto qui porte le code, en CAD, à même votre solde prépayé. Une vérification refusée par l’opérateur est remboursée en entier, et les vérifications en mode test sont gratuites.

Puis-je vérifier des numéros à l’extérieur du Canada ?

Non. Verify n’envoie qu’à des numéros canadiens, et tout autre numéro est refusé avec NON_CANADIAN_NUMBER avant toute facturation.

Que se passe-t-il après trop de codes erronés ?

Après cinq codes erronés, la vérification est bloquée avec VERIFICATION_MAX_ATTEMPTS et son code ne fonctionne plus. Lancez une nouvelle vérification pour envoyer un nouveau code; un même numéro peut en recevoir un par minute.

Ai-je besoin de mon propre numéro de téléphone ?

Pour les codes en production, oui : le code part de l’un de vos numéros HonkIO. Une clé de test accepte comme expéditeur tout numéro canadien ou américain valide : vous pouvez bâtir d’abord et acheter un numéro ensuite.

Puis-je modifier le texte du message ?

Vous choisissez le nom de l’application affiché dans le message, jusqu’à 64 caractères de texte brut. Le reste est fixe : le message donne le code, indique quand il expire et demande à la personne de ne pas le communiquer.

• API SMS

  Envoyez et recevez des SMS avec des numéros canadiens locaux et sans frais, avec le consentement LCAP et les réponses STOP appliqués par l’API.

• Agents IA et MCP

  Un serveur MCP qui permet aux agents IA d’envoyer des SMS, de vérifier des numéros, d’acheter des numéros canadiens et de vérifier le consentement LCAP par HonkIO.

• Les API SMS au Canada comparées

  Les API SMS pour le Canada comparées sur la LCAP, le désabonnement en français, le lieu de stockage des données et les prix en CAD.