Codes de vérification SMS jamaïcains : checklist, étapes et correctifs

Que vérifier avant la première activation jamaïcaine ?

La Jamaïque fait partie du plan de numérotation nord-américain (NANP) : plusieurs contrôles diffèrent donc de la plupart des pays :

• Votre validateur accepte les numéros +1 qui ne sont ni américains ni canadiens. Beaucoup de formulaires d'inscription supposent discrètement que tout numéro +1 est américain.
• Votre sélecteur de pays liste la Jamaïque séparément, au lieu de traiter +1 comme une région unique.
• Une clé d'API or_live_ existe dans la console Développeur, et un endpoint de webhook avec son secret est déployé, ou votre banc de test est réglé pour interroger.
• Le portefeuille est approvisionné, ou le mode sandbox a été activé pour un essai à blanc.
• Vous connaissez l'identifiant du service grâce à GET /api/v1/services ; l'identifiant de pays de la Jamaïque est jm.

Si les deux premiers points sont mal gérés, les échecs ressemblent à des problèmes de routage alors qu'ils se trouvent entièrement dans votre propre code.

Pourquoi un numéro jamaïcain en +1 demande-t-il un traitement particulier ?

Les numéros jamaïcains utilisent les indicatifs régionaux 876 et, plus récent, 658, suivis d'un numéro d'abonné à sept chiffres : la forme E.164 complète est donc +1 plus dix chiffres. En national, on compose un 1 initial pour les appels interurbains, à retirer avant le stockage.

Le point important pour les ingénieurs : +1 seul ne dit rien du pays. La détection de la région doit examiner l'indicatif régional, et toute logique qui choisit une devise, un fuseau horaire ou un modèle de SMS à partir de l'indicatif doit prendre la même précaution. Stockez la chaîne E.164 canonique, gardez la région détectée dans un champ séparé et testez des entrées en 876 comme en 658.

L'anglais est la langue officielle et les SMS de vérification arrivent presque toujours en anglais, tandis que le parler courant utilise souvent le patois jamaïcain. Les équipes testent ici pour des lancements aux Caraïbes, pour des parcours de transfert d'argent et de fintech destinés à la diaspora aux États-Unis, au Royaume-Uni et au Canada, et pour des produits de tourisme et d'hôtellerie. L'article routage par pays pour l'OTP explique comment choisir les routes marché par marché.

Quelles sont les étapes de l'API de vérification SMS pour la Jamaïque ?

1. Consultez les prix en direct avec GET /api/v1/prices?country=jm&service=<id> sur l'URL de base https://otproute.com/api/v1.
2. Commandez : POST /api/v1/activations avec le corps {"service": "<id>", "country": "jm"}. Notez l'identifiant d'activation et le numéro.
3. Saisissez le numéro dans l'application que vous testez.
4. Recevez le code par l'événement activation.sms_received sur votre webhook, ou en interrogeant GET /api/v1/activations/{id}.
5. Abandonnez tôt une tentative jamaïcaine en envoyant POST /api/v1/activations/{id}/cancel, ce qui libère la réservation.

Avant d'agir sur un événement, recalculez le HMAC-SHA256 de "<t>.<raw body>" avec le secret de votre endpoint, comparez-le à la valeur v1 de X-OTPRoute-Signature et refusez les horodatages trop anciens. Traitez aussi activation.expired et activation.cancelled, en vous appuyant sur l'identifiant d'activation, pour que les nouvelles tentatives ne soient jamais traitées deux fois. Pour dimensionner votre usage, un même compte peut détenir 10 clés et 5 endpoints de webhook, avec un plafond de 300 requêtes par minute pour l'ensemble.

Quelles applications peuvent recevoir des codes sur une route jamaïcaine ?

La Jamaïque liste actuellement plus de 900 services. Parmi les plus utilisés : WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Snapchat, Amazon, Uber, Netflix, Airbnb et ChatGPT (OpenAI).

La disponibilité de chaque service évolue au fil de la journée : lisez le point d'accès des prix au début de chaque exécution plutôt que de figer une liste dans le code.

Comment les non-développeurs suivent-ils la même checklist dans le tableau de bord ?

Créez un compte sur /signup avec un code e-mail ou Google, activez le TOTP et rechargez. Ouvrez ensuite l'OTP Gateway, choisissez le service, choisissez la Jamaïque et confirmez le prix en direct. Collez le numéro dans l'application : le code apparaît dans le tableau de bord dès l'arrivée du texto. Les équipes de support utilisent souvent ce chemin pour reproduire le problème d'inscription d'un client sur un numéro jamaïcain.

Dépannage : le code jamaïcain est en retard, absent ou refusé

• Rejeté à la saisie ? Vérifiez d'abord votre propre formulaire ; un validateur réservé aux États-Unis est un coupable fréquent. Si c'est l'application tierce elle-même qui refuse le numéro, elle n'accepte peut-être pas les numéros virtuels.
• Rien pour l'instant ? Laissez l'activation ouverte pendant ses 20 minutes plutôt que d'annuler et de recommander.
• Toujours rien ? Réessayez plus tard ou avec une autre route de service. Évitez de marteler la même commande en boucle.

Quand aucun SMS n'atteint le numéro avant la fin de la fenêtre, la totalité du montant est automatiquement recréditée sur le portefeuille. Le guide réduire les échecs de livraison OTP propose une checklist plus longue.

Les lignes dédiées, le portefeuille et le sandbox s'appliquent-ils à la Jamaïque ?

Partager l'indicatif +1 ne fait pas de la Jamaïque une partie du produit dédié. Les numéros virtuels dédiés ne sont vendus que pour les États-Unis et le Canada, dès $1.95/mois, et il n'existe pas de numéro jamaïcain de longue durée en libre-service. Si vous en avez besoin, écrivez à [email protected] pour vous renseigner ; la réglementation locale décide et rien n'est promis.

Tout le reste fonctionne comme partout : un portefeuille prépayé en USD, sans frais mensuels, recharge par carte ou en USDT/USDC, et une facture PDF envoyée par e-mail pour chacune. Le mode sandbox, disponible sur demande, renvoie des numéros et des codes simulés pour les tests d'intégration. Voir /pricing pour le fonctionnement des frais.

Questions fréquentes

Puis-je tester la vérification téléphonique jamaïcaine de mon application sans être à Kingston ?

Oui. Commandez un numéro +1 876 ou +1 658 pour votre service via OTP Route et lisez le code dans le tableau de bord ou via l'API, où que se trouve votre équipe.

Quel identifiant de pays dois-je envoyer pour la Jamaïque ?

Envoyez jm. L'indicatif est +1, mais l'API identifie le pays par cet identifiant.

Un numéro jamaïcain compte-t-il comme un numéro américain ?

Non. Il partage l'indicatif +1, mais c'est un pays distinct avec ses propres indicatifs régionaux, et de nombreuses applications le traitent comme la Jamaïque.

Que devient mon argent si le code jamaïcain n'arrive pas ?

Si aucun SMS n'arrive en 20 minutes, ou si vous annulez, la totalité du montant retourne sur le portefeuille.

Puis-je acheter un numéro jamaïcain de longue durée chez OTP Route ?

Pas en libre-service. Les numéros dédiés de longue durée ne couvrent que les États-Unis et le Canada ; écrivez au support pour vous renseigner sur la Jamaïque.

Peut-on tester le flux de webhook sans payer ?

Demandez le mode sandbox sur un compte de développement. Il renvoie des numéros et des codes simulés, et l'article capture d'OTP par webhook explique le côté gestionnaire.

Quels usages d'un numéro +1 jamaïcain sont autorisés pour les tests ?

Tester votre propre produit, l'automatisation QA et l'exploitation de comptes professionnels légitimes. La route caribéenne est soumise aux conditions propres à chaque application ainsi qu'à la Politique d'utilisation acceptable d'OTP Route.

Les noms de services sont des marques déposées de leurs propriétaires respectifs. OTP Route n'est affilié à aucun d'entre eux. Utilisez les numéros de manière licite et respectez les conditions de chaque service ainsi que notre Politique d'utilisation acceptable.