テスト用番号で Battle.net の SMS コードを受け取る手順

状況：スタジオまたは eスポーツチームが、自分たちで管理できる Battle.net の電話番号を必要としている

Blizzard のゲームを軸にしたコンパニオンツール、オーバーレイ、トーナメントソフトウェアを開発する会社の QA リードを想像してください。チームはテストと配信のために会社の公式アカウントを運用しており、エンジニアの個人の携帯番号をそれに紐づけたい人はいません。もう一つよくあるのは、運用スタッフがチーム共有のアカウントを管理する eスポーツ組織で、認証がチーム全員の見える場所に届く必要があるケースです。

Battle.net は電話番号をいくつもの目的で使います。アカウントの背後にいる本人の確認、重要な情報の変更時のコード送信、アカウント回復の補助、そして Blizzard Authenticator アプリと並ぶセキュリティ層です。一部の Blizzard タイトルでは、プレイ前にアカウントへの電話番号の登録を求めたこともあります。そのため、テスト用の Battle.net SMS 認証は、チームが何度も再現する必要があるフローに関わります。

Battle.net 用の仮想番号を注文する前のチェックリスト

• 適切な製品を選ぶ。 1 回限りの確認なら OTP Gateway が向いています。電話を紐づけたまま、今後のセキュリティ確認を通過しなければならないアカウントは、専用番号（Dedicated Number）を使います（下記参照）。
• 国を合わせる。 Battle.net アカウントの国は作成時に選ばれ、通常はユーザーがあとから切り替えられません。そのため、アカウントと同じ市場の番号を注文してください。
• 認証情報を準備する。 Developer コンソールで発行した Bearer キー（プレフィックス or_live_）と、できればシークレット付きの Webhook エンドポイント。
• ウォレットに入金する。 カードまたは USDT/USDC でプリペイドの USD ウォレットに入金します。月額プランはありません。
• サンドボックスで試運転する。 サポートに依頼すれば開発用アカウントをサンドボックスに切り替えられ、費用をかけずに、連携がシミュレートされた番号とコードを受け取れます。

チームが再利用可能なテストデータをどう整理しているかは、QA テストのページで紹介しています。

Battle.net の OTP を受信できるのはどの国か？

battle_net ルートは現在 197 か国に及びます。たとえば米国、カナダ、英国、ドイツ、フランス、スペイン、ポーランド、スウェーデン、韓国、台湾、日本、シンガポール、フィリピン、オーストラリア、ブラジル、メキシコ、トルコ、南アフリカなどが含まれます。Blizzard は地域別のゲームハブを通じてプレイヤーにサービスを提供しているため、選ぶ国は、たまたま最も安いルートではなく、テストケースが対象とする地域とストアフロントを反映させてください。国ごとの最新の提供状況は GET /api/v1/prices で取得できます。

Battle.net 認証コード API のフローはどう動くのか？

ベース URL は https://otproute.com/api/v1、認証は Bearer、上限は 1 分 300 リクエストです。

1. 料金と提供状況を確認します。GET /api/v1/prices?country=<id>&service=battle_net。国 ID は GET /api/v1/countries から取得します。
2. POST /api/v1/activations に {"service": "battle_net", "country": "us"} のような本文を送ってアクティベーションを作成します。
3. 返ってきた番号を Battle.net に入力して、コードを要求します。
4. Webhook で activation.sms_received を処理します。エンドポイントのシークレットで <t>.<raw body> の HMAC-SHA256 を計算して X-OTPRoute-Signature を検証し、古いタイムスタンプは拒否します。
5. ハンドラーを冪等にします。アクティベーション ID をキーにして処理し、再試行された配信で同じコードが二重に送信されないようにします。
6. 公開エンドポイントがない場合は、代わりに GET /api/v1/activations/{id} をポーリングし、activation.expired または activation.cancelled イベントをそのテスト実行の終了と見なします。

キューイングや再試行の詳細は、Webhook 取得ガイドで解説しています。

開発者でない人はダッシュボードで何をするのか？

OTP Gateway を開き、Battle.net とアカウントの国を選び、表示された料金を確認して注文を確定します。番号を Battle.net の電話番号欄に入力して SMS を要求し、アクティベーションのページを開いたままにしておくと、配信されたときにコードがそこに表示されます。同じ 20 分の有効時間と自動返金が適用されます。

Battle.net のコードが届かないのはなぜか？

Blizzard は、一部のセキュリティ機能で仮想番号やプリペイド型の番号を拒否することがあり、その方針は予告なく変わることがあります。コードがまったく届かない場合は、有効時間が終わるか、キャンセルすれば、全額がウォレットに戻ります。そのうえで次のようにします。

• 配信のタイミングはサービスとルートによって異なるため、有効時間が終わるまで待ちます。
• あとで、またはアカウントに合う別の国で再試行します。
• キャンセルと再注文を素早く繰り返すのは避けます。レート制限を無駄にします。
• 番号が完全に拒否された場合は、回避策を探すのではなく、方針としての回答と受け止めます。

配信失敗のチェックリストに、記録しておくべきシグナルをさらに挙げています。

専用番号が Battle.net の電話番号として適しているのはどんなときか？

1 コード用の番号は有効時間が過ぎると消えるため、再びセキュリティコードを受信する必要があるアカウントには向きません。長く使う会社のアカウントには、米国またはカナダの専用番号（Dedicated Number）が月額 $1.95 からで、ウォレットから更新される間同じ回線を保持し、受信した SMS をダッシュボードと、number.sms_received として Webhook に転送します。

どちらを選ぶ場合も、Blizzard の規約を守ってください。アカウントは実在の個人または事業者につき 1 つとし、余分なアカウントや、停止措置を回避する試みはいけません。OTP Route は、ご自身の正当なアカウントと製品のテストと運用のためのサービスであり、利用規約（Acceptable Use Policy）が適用されます。Battle.net はその所有者の商標であり、OTP Route は提携していません。

よくある質問

個人の電話を使わずに Battle.net の OTP を受信できますか？

はい。battle_net 用の OTP Gateway の番号を注文して Battle.net に入力し、ダッシュボードか Webhook でコードを読み取ります。料金は 1 コード $0.20 からで、配信されたときにのみ課金されます。

Battle.net はどの仮想番号でも受け付けますか？

いいえ。Blizzard は一部の機能で仮想番号やプリペイド番号を拒否することがあるため、届かなかったアクティベーションは自動的に返金されます。

Battle.net のテストアカウントには、どの国を選べばよいですか？

アカウントと同じ国を使ってください。Battle.net アカウントの国は作成時に設定されるため、番号が一致しないと分かりにくい結果になることがあります。

API での Battle.net のサービス ID は何ですか？

サービス ID は battle_net です。POST /api/v1/activations で国 ID と組み合わせます。

Battle.net の Webhook ハンドラーが同じコードで二度動作しないようにするには？

activation.sms_received を最初に処理するときにアクティベーション ID を保存し、署名を検証したうえで、同じ ID を持つ以降の配信は無視します。

あとでコードが必要になる会社のアカウントに、一時的なアクティベーションを使うべきですか？

いいえ。繰り返しのセキュリティ確認には、米国またはカナダの専用番号が月額 $1.95 からで、更新される間同じ回線を保持できます。

Battle.net のルートは何か国をカバーしていますか？

最新のスナップショットでは 197 か国です。提供状況は一日のなかで変わるため、注文前に API で最新の価格を確認してください。

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