中米向けプロダクトチームのためのホンジュラス認証番号

中米向けにプロダクトを開発するチームに、ホンジュラスの番号が必要なのはなぜですか？

ホンジュラスは、グアテマラ、エルサルバドル、ニカラグアと並ぶ、中米全体への展開の中の1拠点であることがよくあります。これらの国にはそれぞれ独自のダイヤルコードとルートがあるため、グアテマラの番号で動くフローから、テグシガルパやサンペドロスーラの顧客に見える画面を推測することはほとんどできません。

次の3つの場面が繰り返し登場します。

• 市場ローンチ。 ホンジュラスで始めるフィンテック、デリバリー、マーケットプレイスのアプリは、広告を出す前に、サインアップのSMSが実際に+504番号へ届くことを確かめたいと考えます。
• スペイン語のローカライズQA。 ホンジュラスはスペイン語圏で、コードは通常スペイン語で届きます。アクセント付きの文字には基本のGSMアルファベットに含まれないものがあるため、それらを使ったテンプレートはUnicodeで送信され、想定より早く分割されることがあります。実際のホンジュラスのテスト番号を使えば、最終的な表示を確認できます。
• ディアスポラの顧客。 多くのホンジュラス人が米国に住みながら、母国の番号に紐づいたアカウントを管理し続けています。送金、通信のチャージ、サポートのチームにとって重要なポイントです。

この地域のメッセージング習慣はWhatsAppに大きく偏っているため、それをカバーする+504のテストは、現地のユーザーの多くが実際にサインインする方法を反映します。

データベース上で、+504番号はどのように見えますか？

ホンジュラスの番号は8桁で、トランクプレフィックスはありません。国内番号は XXXX-XXXX と書き、国際形式は国コードを付けるだけの +504XXXXXXXX です。

この単純さには落とし穴があります。国コードのない8桁の数字列は、ほかの複数の国では有効な番号に見えるため、桁数だけで地域を推測するパーサーは、誤った国コードを付けてしまうことがあります。次の習慣を守ってください。

1. 常にE.164で保存します。+504 と8桁、それ以外は何も付けません。
2. ユーザーが前半と後半の間に入力するハイフンを取り除きます。
3. サインアップフォームで選ばれた国を記録し、推測ではなく、その国を使って正規化します。

形式が一貫していれば、多数のアクティベーションを並列で実行するときも、届いたコードを適切なテストユーザーに簡単に対応づけられます。

ホンジュラスの認証番号でテストできるサービスは何ですか？

現在のホンジュラスのスナップショットでは、1,700を超えるサービスが表示されています。人気のものには、WhatsApp、Facebook、Instagram、Uber、TikTok、Telegram、Google（Gmail & YouTube）、Microsoft & Outlook、Amazon、Discord、Snapchat、LinkedIn、ChatGPT（OpenAI）などがあります。

ルーティングできるサービスは一日の中で変わるため、注文する時点で、APIかダッシュボードからライブの一覧を読み取ってください。正午に見つからなかったサービスが、あとで戻っていることもあります。

APIでホンジュラスのSMS OTPコードを受信するには？

Developerコンソールで作成した、or_live_ で始まるBearerキーで https://otproute.com/api/v1 に対して認証します。ホンジュラスOTP APIのテストの流れは次のとおりです。

• GET /api/v1/services でサービスIDが返り、GET /api/v1/countries でホンジュラスが hn であることを確認できます。
• GET /api/v1/prices?country=hn&service=<id> でライブの価格が分かるため、スクリプトは予算を超えるものを拒否できます。
• POST /api/v1/activations に {"service": "<id>", "country": "hn"} を送ると、+504番号が確保され、アクティベーションIDが返ります。
• コードは activation.sms_received のWebhookとして届くか、GET /api/v1/activations/{id} のポーリングで取得できます。
• POST /api/v1/activations/{id}/cancel で、不要になった注文を終了します。

Webhookリクエストには署名が付いています。エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算し、X-OTPRoute-Signature の v1 の値と比較し、古いタイムスタンプは破棄します。重複はアクティベーションIDを冪等性キーとして扱って処理してください。覚えておきたい上限は、1アカウントあたりAPIキー10個、Webhookエンドポイント5つ、1分あたり300リクエストです。このSMS認証APIについては、開発者向け概要と連携ガイドでさらに詳しく解説しています。

技術者以外のスタッフ向けのダッシュボード操作はどうなりますか？

ローンチチームの全員がスクリプトを書くわけではありません。OTP Routeのダッシュボードでは、アクセス権のある人なら誰でもOTP Gatewayを開き、ホンジュラスとサービスを選び、価格を確認して注文を確定できます。+504番号が注文ページに表示されるので、アプリに貼り付けてコードを要求すると、同じ画面にSMSが表示されます。エンジニアとテスターでこの作業をどう分担しているかは、QAテストのページで紹介しています。

+504のコードが届きませんでした。どうすればよいですか？

アクティベーションは20分間有効です。支払いが発生するのは、コードが届いたときだけです。何も届かないままウィンドウが終了した場合、またはキャンセルした場合は、全額が自動でウォレットに戻ります。

再注文の前に、次を確認してください。

1. 2件目の注文を重ねるのではなく、ウィンドウが終わるまで待ちます。
2. サービスが仮想番号を受け付けているか確認します。仕様として拒否するサービスもあります。
3. 時間をおくか、同じフローで別のサービスルートを使って再試行します。
4. 自動化では、タイトなリトライループではなくバックオフを使います。ループはレート制限を消費するだけで、ほとんど効果がありません。

ホンジュラスの恒久的な回線は取得できますか？請求はどのようになっていますか？

ホンジュラスには、セルフサービスの長期番号はありません。+504の回線を継続して必要とするチームは、[email protected] にメールで問い合わせることもできますが、提供可否は現地の規制によるため、確約はできません。参考までに、Dedicated Numbersは米国とカナダのみで販売しており、月額$1.95からです。あとでもう一度ログインする必要があるステージングアカウントに向いています。

OTP Routeの請求は、1つのプリペイドUSDウォレットで行います。月額料金やプランはなく、カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届きます。リクエストに応じて、開発用アカウントにサンドボックスモードを用意しており、模擬の番号とコードで、資金を使わずに連携をテストできます。各サービスの規約と、当社の利用規定（Acceptable Use Policy）を守ってください。

よくある質問

ホンジュラスに住んでいなくても、アプリのホンジュラスアカウントを認証できますか？

はい。OTP Gatewayで+504番号を注文し、アプリでコードを発行させ、ダッシュボードかWebhookで読み取れば、どこからでも行えます。

ホンジュラスの電話番号には、先頭のゼロがありますか？

いいえ。ホンジュラスの番号は8桁でトランクプレフィックスがないため、E.164形式は +504 にその数字を続けるだけです。

APIがホンジュラスに求める国コードは何ですか？

価格を取得するときやアクティベーションを作成するときは、国IDとして hn を使います。

テスト用の+504番号は、どのくらいの時間使えますか？

各アクティベーションは20分間有効で、認証コード1件を処理します。

サービスがSMSを送ってこなかった場合、請求されますか？

いいえ。届かなかったアクティベーションやキャンセルされたアクティベーションは、全額が自動でウォレットに返金されます。

ホンジュラスのOTPルーティングは、グアテマラやエルサルバドルと違いますか？

はい。国ごとにルートとサービス一覧が異なるため、ユーザーが実際にいる市場を指定してテストしてください。

ホンジュラスの認証番号の支払いにステーブルコインを使えますか？

はい。ウォレットはカード決済のほか、USDTとUSDCにも対応しており、チャージのたびにPDFの請求書が発行されます。

サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。