日本の電話番号なしで日本向けに出荷する:+81コードのテスト

日本向けのローンチが、電話番号の手順で止まってしまうのはなぜ?

日本向けのリリースを準備しているチームは、通常、翻訳を終え、決済手段を組み込み、App Storeの掲載内容も下書きしています。そこで誰かが「実際の+81番号でサインアップフローを誰が確認するのか」と尋ねると、場が静まり返ります。

この空白は、予想しやすい場面で現れます。

• ローカライズのQAでは、電話番号フィールドが、ハイフン付きで書いた番号を含め、日本のユーザーが実際に入力する形式を受け付けるか確認する必要があります。
• 現地の運用担当者(東京や大阪)は、端末を変更した後に共有のビジネスアカウントを復旧する必要がありますが、誰も個人の番号をそのアカウントに登録したくありません。
• 日本のプラットフォームとの提携や連携では、ビジネスプロフィールのオンボーディング時に、現地の番号を求められることがあります。

OTP Gatewayは、物理SIMへの依存をなくします。1回の認証用の+81番号を提供し、キャリアパートナー経由のOTPルーティングでSMSを受け取り、結果をお客様のコードやブラウザに渡します。

テストのために+81番号で認証できるものは?

日本の認証番号は現在、1,500を超えるサービスで注文できます。今回のスナップショットで人気のルートには、LINE、X (Twitter)、Amazon、Netflix、Google (Gmail & YouTube)、Instagram、TikTok、Discord、Uber、Airbnb、Microsoft & Outlook、ChatGPT (OpenAI)、Facebook、WhatsAppがあります。

LINEは日本の多くの人にとって標準のメッセージングアプリのため、特記する価値があります。LINEログインやLINE通知を提供するプロダクトでは、通常のSMSに加えて、その経路もカバーしたいはずです。利用可否は一日の中で変わるため、ツールに持たせる一覧は、このページではなくAPIから取得してください。

日本のOTP APIをテストランナーに組み込むには?

SMS認証APIは https://otproute.com/api/v1 にあります。Developerコンソールでキー(or_live_ で始まります)を作成し、Bearerトークンとして送信し、毎分300リクエストの範囲内に収めてください。1アカウントでキー10個とWebhookエンドポイント5つを保持できます。

典型的な流れは次のとおりです。

1. GET /api/v1/services と GET /api/v1/countries でIDを一度だけ解決します。日本は jp です。
2. GET /api/v1/prices?country=jp&service=<id> で現在のレートを取得し、テスト結果とあわせて保存します。
3. {"service": "<id>", "country": "jp"} を本文にして POST /api/v1/activations で注文します。
4. 返された番号をテスト対象のアプリに入力し、SMSを発生させます。
5. Webhookで activation.sms_received を受け取ります。ランナーがファイアウォールの内側にある場合は、GET /api/v1/activations/{id} をポーリングします。
6. ティアダウンでは、テストで不要になったアクティベーションに POST /api/v1/activations/{id}/cancel を呼びます。

Webhookのリクエストには X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を再計算し、安全に比較し、古いタイムスタンプは拒否してください。再試行しても問題ないよう、イベントはアクティベーションIDをキーとして扱います。CIの具体的な内容はCIパイプラインでのSMS OTPテストとQAテストのソリューションをご覧ください。

東京オフィスの非開発者も、ブラウザからできる?

はい。OTP Routeのダッシュボードで、OTP Gatewayを開き、日本とサービスを選択し、表示された価格を確認して確定します。番号はすぐに表示され、メッセージが届くと、その隣にコードが表示されます。インストールは不要なので、サポートリーダーやマーケティング担当者がキャンペーンのランディングフローを確認するのにも実用的です。

日本の携帯番号はどう書式化され、メッセージはどう見える?

日本の国内トランクプレフィックスは 0 です。携帯番号は一般に070、080、090の後ろに8桁を続けて書き、ハイフンで区切ることがよくあります。E.164ではゼロが取り除かれ、090と残りの番号は +81 90 に8桁を足した形になります。保存するのはE.164形式のみにし、ユーザーが入力したハイフンやスペースは取り除き、バリデーターが070の範囲を弾かないようにしてください。

認証メッセージは、漢字・ひらがな・カタカナが混在した日本語で届くことが多く、通常のASCII数字ではなく全角数字が含まれるものもあります。コードを抽出する前に、テキストをUnicodeのNFKC正規化にかけてください。そうしないと、[0-9] の正規表現が静かに見逃すことがあります。また、日本語のテキストはSMSがUnicodeエンコーディングで送られることを意味するため、失敗を後で確認できるよう、ログはUTF-8で保持してください。

コードが表示されませんでした。何を試せばいい?

届かなければ課金されません。SMSが届かないまま20分が経過した場合、またはキャンセルした場合は、全額が自動的にウォレットへ返金されます。再注文する前に次を確認してください。

• ウィンドウに時間を与えてください。遅れて届いたコードも取得されます。
• 少し間をおいて再試行するか、同じサービスで別のルートに切り替えてください。
• そもそもそのサービスが仮想番号を受け付けているか確認してください。拒否するサービスもあります。
• 自動化から短い間隔で再注文を繰り返すのは避け、試行の間隔をあけてください。

ルートごとに違いが出る理由は、OTPの国別ルーティングの記事で説明しています。

日本の長期回線はある?ウォレットの課金は?

OTP Routeには、セルフサービスの日本の長期番号はありません。Dedicated Virtual Numbersは米国とカナダ向けの商品で、月額$1.95からです。長期の+81回線が不可欠な場合は、[email protected] にメールしてください。チームが現地の規制で何ができるかを確認しますが、可能であるという確約はありません。

支払いは、単一の前払いUSDウォレットで行い、サブスクリプションもプランもありません。カードまたはUSDT/USDCでチャージでき、チャージのたびにPDFの請求書がメールで届きます。リクエストにより、開発アカウントを模擬の番号とコードによるサンドボックスモードで運用できます。最新の金額は料金ページをご覧ください。

よくある質問

日本のSIMカードなしで、日本のSMS OTPを受信できる?

はい。OTP Gatewayは1回の認証用に+81番号を発行し、コードをダッシュボードに表示するか、Webhookに送ります。

APIの呼び出しで日本にはどの国IDを送る?

アクティベーションの本文と価格のクエリで jp を使います。

日本語のメッセージでパーサーがコードを見逃すのはなぜ?

メッセージに全角数字が使われている可能性があります。マッチングの前にNFKC正規化を適用すれば、コードは通常の数字パターンにマッチします。

090の番号は先頭のゼロ付きで保存すべき?

いいえ。トランクのゼロを除いて +81 に続けて保存します。たとえば +81 90 と残りの8桁です。

日本の認証コードが届かなかった場合、お金はどうなる?

20分の有効時間が終了するか、アクティベーションをキャンセルすると、自動的にウォレットへ戻ります。

日本市場向けのLINEのサインアップをテストできる?

LINEは日本で利用できるサービスに含まれていますが、利用可否は変動します。最新の一覧を確認し、作成するアカウントについてはLINEの規約に従ってください。

番号の使い方にルールはある?

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

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