ブータンの+975認証コードをテストスイートに取り込む

プロダクトチームがブータンの番号を必要とするのはなぜ?

ブータンは小さな市場ですが、思われている以上に多くのロードマップに登場します。ヒマラヤを訪れる旅行者向けの旅行・ホスピタリティの予約フロー、海外で学んだり働いたりする親族を持つブータンの家族が使う決済・送金アプリ、南アジア全域で同時にリリースされる地域向けアプリなどです。+975 のサインアップが実際に完了することを確認しなければならないQAエンジニアは、自国のSIMでは確かめられません。

国語はゾンカ語ですが、学校、行政、ビジネスでは英語が広く使われています。ブータンのルートで目にする認証SMSの大半は、短い英語のテンプレートです。ただし、プロダクトがゾンカ語にローカライズされている場合は、リリース前に自社のSMS文面が正しく表示されるか確認してください。

運用面の事情もあります。ティンプーやパロでプロジェクトを運営する旅行会社、NGO、コンサルティング会社は、スタッフが個人の電話を渡さずに済むよう、共有の業務ツールをブータンの番号で登録することがあります。そうした一度きりの確認であれば、ゲートウェイのアクティベーション1回で通常は足ります。

+975ルートでコードを送信できるアプリは?

ブータンの最新リストには、現在1,700を超えるサービスが掲載されています。リクエストの多いものは WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Signal、Viber、WeChat、Microsoft & Outlook、Amazon、Airbnb、Uber などです。

このルートの提供状況は日中に変動するため、どのリストもスナップショットとして扱ってください。先週あったものをハードコードするのではなく、注文前にコードから GET /api/v1/services と GET /api/v1/countries を呼び出しましょう。

国ID `bt` の呼び出し順序は?

1. https://otproute.com/api/v1 に対し、Developerコンソールで作成したBearerキー(接頭辞 or_live_)で認証します。
2. GET /api/v1/prices?country=bt&service=<id> で、その組み合わせの最新料金を取得します。
3. POST /api/v1/activations に {"service": "<id>", "country": "bt"} のボディを送って注文します。
4. GET /api/v1/activations/{id} をポーリングするか、activation.sms_received、activation.expired、activation.cancelled を購読します。
5. 不要になった番号は POST /api/v1/activations/{id}/cancel で解放します。

Webhookリクエストには X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。エンドポイントのシークレットで "<t>.<raw body>" のHMAC-SHA256を計算し、古いタイムスタンプは破棄してください。ハンドラの全体像はWebhookによるキャプチャのガイドで、すべてのフィールドはAPIドキュメントで確認できます。

各アカウントはAPIキーを最大10個、Webhookエンドポイントを最大5個まで保持でき、1分間に300リクエストまで送信できます。これは、このような小さな市場に対する夜間の回帰テストには十分です。もっとゆっくりしたペースなら、数秒おきに確認するポーリングループが最も部品が少なく済みます。

+975番号はどのように保存すべき?

正規の形式を1つに統一してください。+975 の後に国内の数字を続け、スペース、ハイフン、括弧は使いません。ブータンの携帯番号は8桁で、多くのバリデーターが想定する10桁のパターンより短いため、大きな市場向けに調整された長さのチェックは緩めてください。ユーザーが習慣で先頭に0を入力した場合は、保存前に取り除きます。入口で正規化しておくと、重複排除、不正検知のルール、サポートでの検索が一貫します。

自動テスト用のフィクスチャを作成するときは、長い国際番号のサンプルと並べて、少なくとも1つはブータンの番号を含めてください。ティンプーの実際のユーザーがフォームを拒否されたと報告して初めて発覚するような、桁数の1つ違いのバグを検出できます。

ブータンのコードが届かない場合は?

• 20分の有効時間が終わるまで待ちましょう。メッセージをキューに溜める送信元もあります。
• 対象のアプリが仮想番号を受け付けるか確認してください。拒否するアプリもあります。
• 注文エンドポイントをループで連打せず、少し時間を置いて再試行するか、別のサービスのルートを選んでください。

何も受信しなかった番号には料金がかかりません。返金は自動で行われるからです。さらなる対処法はOTP配信失敗を減らす方法にあります。

アクティベーションIDを自社のテスト実行IDと並べてログに残しておくと、コードが届かないときも、推測に頼らず数秒で原因を追跡できます。

長期回線、課金、サンドボックス

OTP Route には、ブータンのセルフサービス長期番号はありません。専用回線は米国とカナダ向けの製品で、月額 $1.95 からです。ブータンの回線については [email protected] にメールでお問い合わせいただけますが、可否は現地の規則によって決まります。すべて前払い式のUSDウォレットで運用され、月額料金はありません。入金はカードまたはUSDT/USDCで行い、入金のたびにPDFの請求書が発行されます。開発用アカウントはサンドボックスモードを依頼でき、シミュレートされた番号で bt のフロー全体をリハーサルできます。ウォレットの仕組みは料金をご覧ください。

よくある質問

現地SIMなしで、自社アプリのブータンのサインアップフローをテストできますか?

はい。OTP Gateway でサービス用の +975 番号を注文し、アプリからコードを送信させて、ダッシュボードまたはAPIで読み取ってください。

APIでのブータンの国IDは何ですか?

ブータンは bt です。料金のクエリとアクティベーションのリクエストボディで指定します。

ブータンの認証コード1件はいくらですか?

ブータンのコードは $0.20 からで、料金はサービスによって異なります。正確な金額は、確定する前に GET /api/v1/prices で返されます。

ブータンのOTPメッセージは通常どの言語ですか?

主に英語で、ブータンのビジネスや教育で広く使われています。国語はゾンカ語なので、ゾンカ語で送信する場合は自社のローカライズ済みテンプレートをテストしてください。

+975番号が何も受信しなかった場合、課金されますか?

いいえ。20分以内にSMSが届かなかった場合、または先にキャンセルした場合は、全額が自動的にウォレットに戻ります。

繰り返しのログイン用にブータンの番号を保持できますか?

セルフサービスでは提供していません。長期番号は米国とカナダのみです。ブータンについては、チームにメールでお問い合わせください。

ブータンの番号で多数のアカウントを作成してもよいですか?

いいえ。OTP Route は、ご自身の正当なプロダクトのテストと運用にのみ使用してください。各サービスの利用規約を守り、利用規定(Acceptable Use Policy)が適用されることにご留意ください。

ウォレットはどの支払い方法に対応していますか?

カードと、USDTまたはUSDCのステーブルコインです。従量課金のみで、選ぶプランはありません。

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