Collecter par programmation les codes OTP indonésiens +62

Quels endpoints une intégration de l'API OTP Indonésie appelle-t-elle ?

Tout passe par https://otproute.com/api/v1 avec une clé Bearer portant le préfixe or_live_. Créez-en une dans la console développeur ; un compte peut détenir jusqu'à 10 clés, ce qui permet de séparer facilement un exécuteur de CI d'une machine de préproduction.

1. Récupérez GET /api/v1/services et GET /api/v1/countries et mettez les deux listes en cache. L'Indonésie apparaît avec l'identifiant id.
2. Demandez GET /api/v1/prices?country=id&service=<id> pour connaître le prix et la disponibilité actuels du service que vous allez tester. Le stock évolue pendant la journée ; interrogez-le donc à chaque exécution plutôt que de le coder en dur.
3. Créez la commande avec POST /api/v1/activations et un corps tel que {"service": "tokopedia", "country": "id"}. Vous recevez un identifiant d'activation et un numéro +62.
4. Saisissez ou injectez ce numéro dans le champ téléphone de votre propre application ou compte de test.
5. Lisez le résultat par webhook, ou interrogez GET /api/v1/activations/{id}. Abandonnez proprement avec POST /api/v1/activations/{id}/cancel quand un test échoue avant l'étape SMS.

Un rapide GET /api/v1/balance avant le début de la suite permet à une exécution d'échouer tôt plutôt qu'à mi-chemin. Une interrogation à intervalle raisonnable tient aisément dans le plafond de 300 requêtes par minute. Les schémas complets se trouvent dans la documentation de l'API.

Comment traiter les codes +62 avec un webhook signé ?

L'interrogation convient à un développeur seul ; les tâches parallèles sont plus sereines avec une livraison en push. Enregistrez jusqu'à 5 endpoints par compte et abonnez-vous à activation.sms_received, activation.expired et activation.cancelled.

Chaque requête inclut un en-tête X-OTPRoute-Signature de la forme t=<unix>,v1=<hex>. Reconstituez la chaîne signée <t>.<raw body>, calculez le HMAC-SHA256 avec le secret de l'endpoint et comparez-le à v1 en temps constant. Hachez les octets bruts avant tout parsing JSON et écartez les requêtes dont l'horodatage est trop ancien pour qu'une charge utile capturée ne puisse pas être rejouée.

Considérez les événements comme indexés sur l'identifiant d'activation et rendez le gestionnaire idempotent : une livraison rejouée doit simplement trouver le code déjà stocké. Notre article sur la sécurité des webhooks HMAC détaille les vérifications.

Quels services peuvent recevoir des SMS OTP indonésiens sur OTP Route ?

L'instantané en direct pour l'Indonésie couvre plus de 3 000 services. Les routes populaires comprennent WhatsApp, Tokopedia, Shopee, Lazada, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LINE, Discord, Microsoft & Outlook et ChatGPT (OpenAI).

Pour les collègues qui ne touchent jamais à l'API, le tableau de bord fait le même travail : connectez-vous, choisissez le service, choisissez l'Indonésie, vérifiez le prix affiché et commandez. Le numéro +62 s'affiche à l'écran et le code apparaît à côté dès l'arrivée du SMS. Annulez depuis la même vue si le test est abandonné.

Comment stocker et normaliser un numéro +62 ?

L'Indonésie utilise un préfixe de ligne 0 ; on écrit donc les numéros mobiles en national sous la forme 08 suivi du reste des chiffres. En E.164, le 0 disparaît : un numéro écrit localement 0812... devient +62812.... Stockez la forme E.164, normalisez tout ce que l'utilisateur saisit en retirant espaces, tirets et le 0 initial, et laissez une bibliothèque de numéros de téléphone maintenue juger de la validité, car les numéros d'abonnés indonésiens n'ont pas tous la même longueur.

Les modèles de SMS envoyés aux numéros indonésiens sont fréquemment en bahasa indonesia, même si certains services envoient de l'anglais. Extrayez le code avec un motif numérique plutôt qu'en repérant des mots comme « kode » ou « code », et votre analyseur se moquera de la langue du modèle.

Pourquoi les équipes produit testent-elles les parcours d'inscription en Indonésie ?

L'Indonésie est l'un des pays les plus peuplés du monde et son usage d'Internet est massivement orienté mobile ; la vérification du numéro de téléphone se trouve donc en tête de nombreux parcours d'onboarding. Les équipes qui s'étendent en Asie du Sud-Est veulent voir leurs propres écrans d'inscription et de connexion indonésiens se comporter correctement avec un vrai numéro +62, vérifier que les textes en bahasa indonesia s'affichent sans troncature, et confirmer que leurs règles antifraude ne bloquent pas des utilisateurs locaux légitimes.

Les équipes d'exploitation régionales et de places de marché utilisent aussi la route pour vérifier les comptes professionnels qu'elles gèrent pour des boutiques indonésiennes. La page tests QA explique comment intégrer cela à un plan de non-régression.

Que faire si le code indonésien n'apparaît jamais ?

Le délai de livraison dépend du service et de la route ; laissez donc de la marge à l'activation avant de décider qu'elle a échoué. Quand aucun SMS n'arrive :

• Laissez la fenêtre de 20 minutes se terminer, ou annulez ; dans les deux cas, la totalité du montant retourne automatiquement sur votre portefeuille.
• Commandez à nouveau un peu plus tard, ou essayez une autre route de service si votre test le permet.
• Confirmez que le service cible accepte les numéros virtuels pour cette action. Certains non, et c'est précisément pourquoi la règle de remboursement existe.
• Évitez de recommander en boucle serrée. Espacez les tentatives pour qu'une tâche de CI ne brûle pas ses relances en quelques secondes.

D'autres pistes de diagnostic figurent dans réduire les échecs de livraison d'OTP.

Existe-t-il un numéro +62 dédié, et comment est-il facturé ?

Non. Une ligne indonésienne longue durée en libre-service n'est pas proposée. Les numéros dédiés sont un produit américain et canadien, à partir de $1.95/mois. Si votre équipe a vraiment besoin d'une ligne +62 durable, écrivez à [email protected] ; la possibilité d'en organiser une dépend de la réglementation locale et n'est pas promise.

La facturation de l'OTP Gateway utilise un seul portefeuille prépayé en USD, sans abonnement mensuel ni forfait à choisir. Alimentez le portefeuille par carte ou en stablecoins USDT/USDC ; chaque recharge déclenche l'envoi par e-mail d'une facture PDF pour votre comptabilité. Les comptes de développement peuvent demander le mode bac à sable, qui renvoie des numéros et des codes simulés pour des tests d'intégration de bout en bout sans dépenser de fonds. Consultez les tarifs ou créez un compte.

Questions fréquentes

Puis-je tester l'inscription indonésienne de mon application sans carte SIM locale ?

Oui. Commandez un numéro +62 sur l'OTP Gateway pour le service concerné, saisissez-le dans votre application et lisez le code dans le tableau de bord ou via l'API.

Quel identifiant de pays l'API OTP Route utilise-t-elle pour l'Indonésie ?

L'Indonésie est id ; une consultation de prix s'écrit donc GET /api/v1/prices?country=id&service=<id>.

Est-ce que je paie si le SMS indonésien n'arrive jamais ?

Non. Si rien n'arrive pendant la fenêtre de 20 minutes, ou si vous annulez, la totalité du montant retourne automatiquement sur votre portefeuille.

Dois-je conserver le 0 initial en enregistrant un numéro mobile indonésien ?

Conservez-le uniquement pour l'affichage au format local. Stockez +62 suivi du numéro national sans le 0, ce qui correspond à la forme E.164.

Les SMS de vérification indonésiens seront-ils en anglais ?

Pas toujours. Beaucoup arrivent en bahasa indonesia ; analysez donc le code numérique plutôt que de vous appuyer sur les mots environnants.

Les numéros indonésiens sont-ils autorisés pour n'importe quel usage ?

Uniquement pour un usage légitime : tester et exploiter vos propres produits et comptes dans le respect des conditions de chaque service. La politique d'utilisation acceptable d'OTP Route s'applique à chaque commande.

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.