QAとOTPルーティングのためのバミューダ認証番号

なぜバミューダの番号は電話番号検証コードでつまずくのか

バミューダは北米番号計画(NANP)に属しているため、番号は +1 の国番号をアメリカ、カナダ、カリブ海の多くの地域と共有しています。バミューダの番号を特徴づけるのは市外局番441で、その後に7桁の加入者番号が続きます。この点でつまずくサインアップフォームは少なくありません。+1 の番号をすべてアメリカとみなすバリデーターは、バミューダのユーザーを米国在住と判定したり、誤った国旗を適用したり、ハードコードされたリストに市外局番がないために番号を拒否したりします。

データベースでバミューダの番号をきれいに保つためのルールをいくつか挙げます。

• スペースや句読点のない、完全なE.164文字列(+1441 と7桁)で保存します。
• 多くのヨーロッパの番号計画と異なり、取り除くべき先頭の 0 のトランクプレフィックスはありません。ユーザーが代わりに先頭の 1 を入力することがあるので、正規化処理でそれを受け付けましょう。
• 分析や不正検知のルールが正しい地域を認識できるよう、+1 だけでなく市外局番から地域を判定します。
• 現地の読者向けには (441) XXX-XXXX の形式で表示し、機械が扱う処理にはE.164を使い続けます。

公用語は英語なので、+1 441 番号宛の認証SMSは通常英語で届きますが、文面は常に送信元サービスが決めます。

バミューダ市場に向けたサインアップフローをテストする必要があるのは誰?

島は小さいものの、国際ビジネスでの存在感は非常に大きい国です。保険・再保険グループ、ファンド管理会社、そのほか現地に登記上の拠点を持つ企業が、電話コードを求めるスタッフ用ポータルやクライアント向けアプリを運用しています。ホスピタリティや観光系のプロダクトでは、旅行者や住民が予約や配車のフローで現地の番号を入力します。いずれの場合も問いは同じです。自社のプロダクトは +1 441 番号を受け付け、コードを正しくルーティングし、アカウントに正しい国を紐付けられるでしょうか。

実際のバミューダルートで短い回帰テストスイートを実行すれば、サービスから番号までの実際のSMS経路を通るため、モックを使ったテストよりも早く答えが得られます。チームがそうしたスイートをどう構成しているかは、QAテストガイドをご覧ください。

現在、+1 441 番号にコードを配信できるアプリは?

バミューダのルートには、ライブカタログに200を超えるサービスが掲載されています。現在のスナップショットで人気のあるものは WhatsApp、Telegram、Google (Gmail & YouTube)、Microsoft & Outlook、LinkedIn、Uber、Airbnb、Amazon、Netflix、Signal、Discord、ChatGPT (OpenAI) などです。

キャリアパートナーが容量を追加したり終了したりするため、提供状況は日中に変わります。だからこそカタログは静的なページではなくライブの呼び出しになっています。先週あったものをハードコードするのではなく、実行時に GET /api/v1/countries と GET /api/v1/services を呼び出してください。

APIでバミューダのOTPを受信するには?

すべてのリクエストは、Developerコンソールで発行したBearerキーを付けて https://otproute.com/api/v1 に送ります。キーは or_live_ で始まり、最大10個まで保持できるため、環境ごとのキー運用が簡単です。バミューダの国IDは bm です。

1. GET /api/v1/prices?country=bm&service=<id> で最新の料金を取得し、サービスが利用できない場合はジョブを停止します。
2. POST /api/v1/activations で注文を作成します。例:{"service": "uber", "country": "bm"}。アクティベーションIDと +1 441 番号が返ります。
3. その番号を、テスト中のアプリに入力します。
4. Webhookで activation.sms_received を待つか、1分間300リクエストの上限内で数秒おきに GET /api/v1/activations/{id} をポーリングします。
5. 未使用のものは POST /api/v1/activations/{id}/cancel で解放します。

Webhookの配信には X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。エンドポイントのシークレットを使って <t>.<raw body> のHMAC-SHA256を再計算し、定数時間で比較して、古いタイムスタンプのリクエストは破棄してください。手順はHMACの記事で解説しています。再送された配信が二重に処理されないよう、ハンドラはアクティベーションIDをキーにしてください。詳細なリファレンスはAPIドキュメントにあります。

開発者でなくてもバミューダの認証番号を注文できますか?

はい。APIを使えない運用スタッフやテスターも、ダッシュボードで同じことができます。OTP Gateway を開き、バミューダを選び、サービスを選び、注文前に表示される料金を確認して確定します。+1 441 番号がすぐに表示され、サービスが送信するとその横にコードが表示されます。それをアプリにコピーすれば完了です。

441番号へのコードが届かない場合は?

すべてのアクティベーションには20分の有効時間があります。その間にSMSが届かなかった場合、または先にキャンセルした場合は、全額が自動的にウォレットへ返金されます。支払いが発生するのはコードが届いたときだけです。

• 失敗と判断する前に、有効時間をそのまま待ちましょう。遅れて送信するサービスもあります。
• 短時間に再注文を繰り返さず、時間を置いて再試行するか、別のサービスのルートでテストしてください。
• そのサービスが仮想番号を受け付けるか確認します。拒否するサービスもあり、返金はまさにその場合のためのものです。

番号は、ご自身のプロダクトと正当な業務用アカウントでのみ使用し、各サービスの利用規約に従ってください。OTP Route の利用規定(Acceptable Use Policy)も適用されます。

バミューダの長期回線はありますか?課金の仕組みは?

セルフサービスで利用できるバミューダの長期番号はありません。専用回線は米国とカナダ向けの製品で、月額 $1.95 からです。詳しくは仮想番号をご覧ください。継続して使える441番回線が必要な場合は [email protected] までメールでご連絡ください。チームが現地の規則で何が可能かを確認しますが、提供の約束はできません。

バミューダの注文は、前払い式のUSDウォレット1つから引き落とされます。月額料金はなく、選ぶプランもありません。カードまたはUSDT/USDCで入金でき、入金ごとにPDFの請求書がメールで届きます。開発者はサンドボックスアカウントを依頼でき、シミュレートされた番号とコードが返るので、ウォレットの資金を動かす前に連携を検証できます。最新の料金は料金ページをご覧ください。

よくある質問

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

はい。OTP Gateway から +1 441 番号を注文し、アプリに入力して、ダッシュボードまたはWebhookでコードを読み取ってください。

APIでのバミューダの国IDは何ですか?

POST /api/v1/activations の country フィールドと、料金のクエリでは bm を使用します。

フォームが +1 441 番号をアメリカの番号と表示するのはなぜですか?

バミューダは +1 の国番号を共有しているためです。国番号だけに頼らず、最新の番号計画ライブラリで441の市外局番から地域を判定してください。

バミューダの認証番号の料金はいくらですか?

料金は1コード $0.20 からで、サービスによって異なります。正確な金額は、注文前にAPIとダッシュボードに表示されます。

コードが届かなかった場合、課金されますか?

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

今後のログイン用にバミューダの番号を保持できますか?

セルフサービスの製品としては提供していません。長期番号は米国とカナダのみです。バミューダについては、サポートにメールでお問い合わせください。

テスト用の +1 441 番号はCIパイプラインで使えますか?

はい。同じREST呼び出しをどのパイプラインからでも実行でき、サンドボックスアカウントなら、ウォレットの資金を使わずにリハーサルできます。

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