OTPルーティングAPIで中国(+86)の会員登録フローを検証する

中国市場には、なぜ専用の認証テスト計画が必要なのですか?

中国は世界最大級のモバイルエコシステムを持ち、その多くが欧米のチームが最初にテストするグローバルアプリではなく、国内プラットフォームの中で完結しています。現地のSIMカードは実名登録制のもとで発行されるため、国内サービスは電話番号を強力な本人確認の手がかりとして扱い、受け付ける番号にも厳しいことが少なくありません。

QAエンジニアが中国ルートを考えるうえで押さえておきたい点は次のとおりです。

• 越境EC。 AlibabaやAliExpressの売り手・買い手は、登録時やアカウント情報の変更時に電話番号を確認します。マーケットプレイスのチームは、そのメッセージをエンドツーエンドで確認したいはずです。
• 中国語の文面。 国内の送信元からのコードは通常、簡体字中国語で届き、多くの場合、冒頭に送信元の名前が【】で囲まれて付きます。英語の「code」という単語を探すパーサーでは見逃してしまいます。
• エンコーディング。 中国語のテキストはUnicode SMSで送られるため、メッセージ本文はUTF-8で保存し、前後の文字に左右されないパターンで数字を抽出してください。

実際のルートで+86番号を使ってテストすれば、この3つの問題を顧客より先に見つけられます。本物の中国キャリア経路へのOTPルーティングが役立つのは、まさにここです。

+86の携帯番号はどのように保存すべきですか?

中国本土の携帯番号は11桁で、先頭は1です。固定電話は国内では市外局番の前に先頭の0(トランクプレフィックス)を付けてダイヤルしますが、携帯番号にはトランクプレフィックスがまったくないため、E.164形式は+86に11桁を続けただけの形になります。

正規化の習慣をいくつか身につけておくと、後のデバッグが楽になります。

• スペースとハイフンを取り除きます。ユーザーは3-4-4桁のグループで入力することがよくあります。
• 先頭の0086や86は、保存前に+86へ変換します。携帯番号の前に0を付けてはいけません。
• 正規化後に桁数を検証します。携帯は国内桁数で11桁、それ以上はありえません。

正規の列はE.164形式で1つだけ持ち、表示用のフォーマットは画面の端でのみ行ってください。アクティベーションで返される番号はすでにこの正規形になっているため、自社の正規化処理のユニットテスト用フィクスチャとして便利です。

現在、中国ルートにコードを送信できるアプリは何ですか?

中国ルートは現在、1,300を超えるサービスに対応しています。ライブスナップショットで目立つものには、WeChat、Alibaba、AliExpress、Microsoft & Outlook、LinkedIn、Telegram、WhatsApp、Google (Gmail & YouTube)、TikTok、Amazon、Discord、ChatGPT (OpenAI)、Claudeなどがあります。

対応状況は、キャリアパートナーが回線を追加・停止するのに応じて日中でも変動します。この一覧は出発点と考えてください。テストマトリクスにサービスIDを固定で書き込むのではなく、GET /api/v1/servicesとGET /api/v1/countriesを呼び出して最新の状況を確認しましょう。

国IDがcnの場合、APIフローはどうなりますか?

開発者コンソールでBearerキー(プレフィックスor_live_)を作成し、クライアントをhttps://otproute.com/api/v1に向けます。典型的な中国OTP APIの実行手順は次のとおりで、同じ手順で対応するどのサービスの中国SMS OTPも受信できます。

1. GET /api/v1/prices?country=cn&service=wechatで、テストする組み合わせのライブ価格を取得します。
2. POST /api/v1/activationsに本文{"service": "wechat", "country": "cn"}を付けて送信し、返されたアクティベーションIDを保持します。
3. テスト対象プロダクトの登録フォームに+86番号を入力します。
4. Webhookでactivation.sms_receivedを受け取ります。Webhookがない場合は、数秒ごとに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を再計算し、定数時間で比較し、古いタイムスタンプは破棄してください。1アカウントにつき、キーは最大10個、Webhookエンドポイントは5つ、リクエストは毎分300回までです。詳しいリファレンスはAPIドキュメントにあります。

コードを書かない人でも中国の番号を注文できますか?

はい。プロダクトマネージャーやサポート担当者は、すべてダッシュボードから行えます。

1. OTP Gatewayを開き、中国を選んでから、サービスを選びます。
2. 注文前に表示される価格を確認します。
3. +86番号を、認証したいアプリにコピーします。
4. アクティベーションカードを見守ります。メッセージを受信すると、すぐにその本文が表示されます。

20分のウィンドウと返金ルールは同じように適用されるため、ローカライズしたオンボーディング画面を手動で確認し、アプリが何も送信しなかった場合でも費用はかかりません。

中国のコードが届かないときは、何を試せばよいですか?

何も届かないときは、たいていサービスがその番号への送信を拒否したか、ルートが混み合っているのが原因で、連携が壊れているわけではありません。落ち着いて順に確認しましょう。

• ウィンドウの時間いっぱいまで待ちます。送信元によっては独自のスケジュールで再送するものがあります。
• そのサービスが仮想番号をそもそも受け付けるか確認します。実名制のプラットフォームでは受け付けないことが多く、自動返金はまさにそのケースのためにあります。
• 少し間を置いてから再試行するか、同じシナリオを別のサービスルートで試します。
• 短い間隔で何度も再注文しないでください。レート制限を消費するだけで、結果が変わることはほとんどありません。

再試行の設計については、OTP配信失敗を減らすためのガイドでさらに詳しく解説しています。

+86番号を長期間保持できますか?また、課金はどうなりますか?

中国向けのセルフサービスの長期回線はありません。Dedicated Numbersはアメリカとカナダ向けの製品で、月額$1.95からです。SMSの受信と送信、ブラウザ通話に対応しています。中国の長期回線が必要な場合は、[email protected]にメールでお問い合わせください。提供可否は現地の規制によるため、お約束はできません。

資金は前払いのUSDウォレット1つにまとまっており、月額課金はなく、選ぶプランもありません。中国向けのテストはこの残高から差し引かれ、残高はカードまたはUSDT/USDCでチャージでき、チャージのたびにPDFの請求書がメールで届きます。詳細は料金ページに、アメリカとカナダの回線については仮想番号の概要にあります。連携作業では、サンドボックスモードをご依頼ください。シミュレートされた番号とコードが返されるため、ウォレットの資金に触れずにパイプラインを実行できます。

よくある質問

中国のSIMなしで、WeChatやAlibabaの登録フローをテストできますか?

OTP Routeでそのサービス用の+86番号を注文し、ダッシュボードまたはAPIでコードを読み取れます。プラットフォームによっては仮想番号を拒否することがあり、その場合、アクティベーションは自動的に返金されます。

OTP Route APIでの中国の国IDは何ですか?

国IDが必要な場所ではcnを使います。たとえばGET /api/v1/prices?country=cn&service=<id>のようにします。

中国の認証メッセージは英語で届きますか?

国内の送信元は通常、簡体字中国語で送信しますが、グローバルアプリは英語やアカウントに合わせた言語で送ることが多いです。コードの抽出は、キーワードではなく数字を基準に組み立ててください。

+86のアクティベーションはどのくらいの時間有効ですか?

20分です。その前にSMSが届かずに終了した場合や、先にキャンセルした場合は、全額がウォレットに戻ります。

中国の認証用番号は、繰り返しのログインに向いていますか?

いいえ。各アクティベーションで受け取れるコードは1回限りで、その後は終了するため、来月もう一度認証が必要なアカウントではなく、会員登録やオンボーディングのテストに向いています。

+86番号の利用には、どのようなルールがありますか?

各プラットフォームの利用規約と、OTP Routeの利用規定(Acceptable Use Policy)を守ってください。この製品は、自社の認証フローのテストや正当な事業用アカウントの運用を目的としており、大量登録には使えません。

CIジョブで、無料で中国の番号を使えますか?

ご依頼いただければ、開発用アカウントをサンドボックスモードに切り替えられます。シミュレートされた番号とコードが返されるため、SMS認証APIのテストをエンドツーエンドで無料で実行できます。

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