テストと運用のための香港（+852）SMS OTP受信

+852番号は、なぜ正規化しやすいのですか？

香港はクローズドな番号計画を採用しています。加入者番号はすべて8桁で、市外局番もなく、取り除くべきトランクプレフィックスもありません。そのため、現地のユーザーが入力する番号は、E.164の +852 に続く8桁と同じです。携帯の番号帯は、通常5、6、9で始まります。

8桁は通常、4桁ずつの2つのグループで書かれるので、サインアップフォームでは検証前にスペースとハイフンを取り除いてください。保存するのは正規の +852XXXXXXXX の文字列にし、比較もその値で行い、整形は表示時にだけ行います。桁数が固定なので、単純な桁数チェックでほとんどの入力ミスは見つかりますが、番号帯の検証には、きちんとした電話番号ライブラリも併用してください。

香港の認証SMSには、どの言語が使われますか？

中国語と英語がどちらも公用語で、日常の話し言葉は広東語、書き言葉の中国語には繁体字が使われます。サービスは、アカウントのロケールに応じて、英語か繁体字中国語でコードを送ることがあり、中国語の文字によるメッセージはUnicode SMSで送られます。

QAにとっての実用的な結論は2つあります。1つ目は、近くの言葉ではなく数字のパターンに一致させてコードを抽出すれば、どちらのテンプレートでもパーサーが動作することです。2つ目は、自社プロダクトでローカライズしたメッセージを送る場合、テンプレートエディターの中だけでなく、受信側でも繁体字中国語版が正しく表示されるかを確認することです。

なぜチームは香港のルートでサインアップテストを行うのですか？

香港は、多くのアジア太平洋地域の企業の拠点で、ユーザーは国際的なアプリと中国本土向けのアプリの両方にアカウントを持っていることが少なくありません。この組み合わせにより、ローカライズ、国境を越えたオンボーディング、サポートのフローを確認するのに役立つ市場になっています。

現在のスナップショットでは、香港で3,600を超えるサービスが表示されています。よく使われるものには、WhatsApp、WeChat、LINE、Signal、Alibaba、Telegram、Google（Gmail & YouTube）、Facebook、Instagram、LinkedIn、Uber、Airbnb、Netflix、AliExpress、Amazonなどがあります。決済やウォレットのプロダクトも、ここでテストされています。香港のオンボーディング画面で電話番号のステップが壊れていると、取引が始まる前に顧客が離脱してしまうからです。ライブの可用性は一日の中で変わるので、実行時に読み取ってください。

国 `hk` を指定した香港OTP APIのフローはどう進みますか？

or_live_ で始まるBearerキーで https://otproute.com/api/v1 に対して認証します。1つのアカウントで保持できるのは、最大でキー10個、Webhookエンドポイント5つです。

1. 名前をIDに対応づけるため、実行ごとに1回、GET /api/v1/services と GET /api/v1/countries を読み取ります。
2. GET /api/v1/prices?country=hk&service=<id> でライブの価格を問い合わせます。
3. POST /api/v1/activations に {"service": "wechat", "country": "hk"} を送ります。
4. テスト対象のフローに+852番号を入力します。
5. activation.sms_received イベントからコードを受け取るか、GET /api/v1/activations/{id} を数秒おきにポーリングする方法に切り替えます。
6. activation.expired または activation.cancelled を受け取ったら、そのテストは「コードなし」として記録して先へ進みます。

X-OTPRoute-Signature ヘッダー（<t>.<raw body> に対するHMAC-SHA256）を検証し、古いタイムスタンプは拒否します。各コールの手順は連携ガイドで順に解説しています。

開発者でない人が香港の認証番号を取得するには？

ダッシュボードでOTP Gatewayを開き、香港とサービスを選んで、表示された価格を確認してから注文します。番号をアプリにコピーしたら、アクティベーションカードを見ていてください。コードは受信され次第、そこに表示されます。サポート担当者が、CIで使うのと同じルートで顧客からの報告を再現するときに便利です。

+852のコードが表示されない場合は？

アクティベーションには、20分間をそのまま与えてください。SMSが届かない場合や、早めにキャンセルした場合、料金は自動でウォレットに戻ります。支払いが発生するのは、コードが届いたときだけだからです。そのうえで、次を確認してください。

• 仮想番号を拒否するサービスもあるため、そのサービスが拒否していないかを確認します。
• 時間をおくか、別のサービスルートを使って再試行します。
• アプリが +852 のあとの8桁をすべて受け取ったかを確認します。余分な先頭のゼロを挿入するフォームは、番号を壊してしまいます。
• タイトなループでの再注文は避けましょう。同じ結果を繰り返すことが多いためです。

香港の長期回線はありますか？請求はどのように行われますか？

OTP Routeには、セルフサービスの長期+852番号はありません。Dedicated Numbersは米国とカナダのみで、月額$1.95からです。詳しくは仮想番号のページで紹介しています。香港の回線が必要な場合は、[email protected] にメールしてください。提供できるかどうかは、現地の規制によります。

そのほかはすべて、プリペイドUSDウォレットによる従量課金で、カードまたはUSDT/USDCでチャージし、チャージごとにPDFの請求書が届きます。開発用アカウントには、リクエストに応じて、模擬の番号を使うサンドボックスモードも用意しています。各サービスの規約と、利用規定（Acceptable Use Policy）を守ってください。

よくある質問

現地のSIMカードなしで、香港のSMS OTPを受信できますか？

はい。OTP Routeは、選んだサービス用の使い切り+852番号を発行し、コードはダッシュボードとWebhookに配信されます。

香港の番号から、トランクプレフィックスを取り除く必要はありますか？

いいえ。香港にはトランクプレフィックスがないため、現地の8桁をそのまま +852 の後ろに付けます。

香港のAPI国IDは何ですか？

価格取得クエリとアクティベーションのボディで、hk を使います。

コードは中国語と英語のどちらで届きますか？

どちらもあり得ます。サービスとアカウントの言語設定によります。どちらのテンプレートでも動作するように、数字をパターンで解析してください。

テスト用の+852番号はいくらですか？

1コード $0.20 からです。サービスごとのライブ価格は GET /api/v1/prices から取得でき、注文前にダッシュボードでも表示されます。

WeChatなどのサービスが何も送ってこなかった場合、返金されますか？

はい。20分以内にSMSが届かなかったアクティベーション、またはキャンセルしたアクティベーションは、全額がウォレットに返金されます。

香港へのOTPルーティングは、CIパイプラインに向いていますか？

Webhookか控えめなポーリングを使い、期限切れを通常の結果として処理するなら、問題ありません。CIパイプラインの記事をご覧ください。

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