+886番号で台湾市場向けの電話認証をテストする

台湾の電話認証はどこが特別なのですか?

台湾はモバイル中心の人口密集市場で、電話番号でのサインアップが当たり前になっています。主流のメッセンジャーも、ヨーロッパや南北アメリカで主力のアプリではなくLINEです。Shopeeのようなマーケットプレイスは日常の買い物に定着しており、海峡の向こうの連絡先とやり取りするためにWeChatも併用するユーザーが多くいます。

プロダクトチームがここでテストするのは、繁体字中国語のローカライズ、コンシューマー向けアプリのローンチ、Eコマースの決済フロー、香港や東南アジアとあわせて台湾を担当する地域オペレーションなどのためです。どの場合も確かめたいことは同じで、実際の+886番号で認証ステップが正しく動くかどうかです。

+886の番号はどのように保存・解析すべきですか?

台湾ではトランクプレフィックス 0 を使います。国内で09xx-xxx-xxxと書く携帯番号は、国際形式では +886 9xx xxx xxx となるため、国番号を付けるときに先頭のゼロを取り除く必要があります。番号はE.164形式(携帯は +886 の後ろに9桁)で保存し、ユーザーがゼロやハイフン付きで入力したものは、入力時にその形式へ変換してください。

認証SMSは繁体字中国語で届くことがよくあります。これらのメッセージはUnicodeで送信されるため、ログ、データベースの列、テストのフィクスチャがマルチバイト文字を扱えるか確認し、前後の文字に左右されないパターンで数字のコードを抽出してください。英語のテンプレートを前提にしたパーサーは、ある市場ではテストが通るのに台湾では失敗する、よくある原因です。

台湾の認証番号にコードを送れるサービスは?

台湾ルートでは1,500を超えるサービスが利用できます。現在のスナップショットで人気のものには、LINE、Shopee、WeChat、WhatsApp、Telegram、Google(Gmail & YouTube)、Facebook、Instagram、Discord、ChatGPT(OpenAI)、Microsoft & Outlook、Amazon、Uber、Airbnb、Netflixなどがあります。在庫やルートは一日の中で変わるため、テスト設定に固定のリストを書くのではなく、ライブの価格取得コールを利用してください。

台湾のOTP APIはどう呼び出しますか?

ベースURLは https://otproute.com/api/v1 で、すべてのリクエストに、開発者コンソールで発行した or_live_ で始まるBearerキーが必要です(最大10キー、1分あたり300リクエスト)。

1. GET /api/v1/services と GET /api/v1/countries でIDを調べます。台湾は tw です。
2. GET /api/v1/prices?country=tw&service=<id> で価格を取得します。
3. POST /api/v1/activations で注文します。例:{"service": "line", "country": "tw"}。
4. 返された+886番号を、サインアップフォームに入力します。
5. 5つあるWebhookエンドポイントのいずれかで activation.sms_received を受信するか、GET /api/v1/activations/{id} をポーリングします。

Webhookは毎回検証してください。X-OTPRoute-Signature ヘッダーには t=<unix>,v1=<hex> が入っており、v1 はエンドポイントのシークレットによる <t>.<raw body> のHMAC-SHA256と一致する必要があります。古いタイムスタンプは拒否し、ハンドラーはアクティベーションIDで冪等にしてください。テストを中断した場合は POST /api/v1/activations/{id}/cancel を呼び出します。市場ごとにルートを選ぶ方法は、国別ルーティングの記事で解説しています。

コードなしで+886のコードを取得する方法はありますか?

はい。ダッシュボードでOTP Gatewayを開き、サービスと台湾を選んで価格を確認し、番号をアプリにコピーします。コードが届くと、アクティベーション画面に表示されます。サポートやグロース担当のスタッフは、エンジニアリングが同じウォレットをAPI経由で動かしている間に、この方法で単発の確認を行えます。

台湾のコードが遅い、または届かないときはどうしますか?

アクティベーションは20分間フルに開いたままにしてください。SMSなしで期限切れになると、手動キャンセルの場合と同様に、お金は自動的にウォレットへ戻ります。

• 時間を置いて再試行してください。利用可否は一日の中で変わります。
• プロダクトが別のサービスルートを用意している場合は、そちらに切り替えます。
• 一部のサービスは仮想番号を拒否します。返金ルールがあるのはそのためです。
• 短い間隔で繰り返し再注文するのではなく、注文の間にバックオフを入れてください。

モバイルアプリのビルドについては、モバイルアプリ認証ガイドで、実機テストファームへの組み込み方を紹介しています。

台湾の番号を維持できますか?利用料金はどうなりますか?

セルフサービスで使える台湾の長期番号はありません。月額$1.95からで、SMSの送受信とブラウザからの通話に対応する専用バーチャル番号は、米国とカナダ限定の商品です。継続的に使える台湾の回線が必要な場合は [email protected] までメールでご相談ください。ただし現地の規制次第であり、確約はできません。

OTP Routeの課金は、月額料金もプランもないプリペイドUSDウォレットです。カードまたはUSDT/USDCでチャージでき、支払いのたびにPDF請求書がメールで届きます。詳細は料金ページをご覧ください。開発用アカウントは、リクエストに応じてサンドボックスに切り替えられ、シミュレーションによるエンドツーエンドの実行が可能です。本プラットフォームはご自身のプロダクトとアカウントに限って利用し、各サービスの利用規約を守り、利用規定が適用されることにご留意ください。

よくある質問

現地のSIMなしで、台湾でのLINEやShopeeのサインアップをテストできますか?

はい。それらのサービスが台湾ルートで利用可能であれば可能です。+886番号を注文してフローで使い、ダッシュボードまたはAPIからコードを読み取ります。

台湾の携帯番号の先頭の0は残すべきですか?

いいえ。トランクプレフィックス 0 を外し、携帯なら +886 の後ろに9桁を付けた形で保存してください。

台湾のSMSからコードを読み取るテストが失敗するのはなぜですか?

メッセージが繁体字中国語であることがよくあります。スタックがUnicodeテキストを扱えるようにし、英語の文言に合わせるのではなく数字を抽出してください。

APIでの台湾の国IDは何ですか?

GET /api/v1/prices とアクティベーションのリクエストボディでは tw を使います。

テスト用の+886番号はいくらですか?

コードは1コード$0.20からで、サービスごとの正確な価格は注文前にリアルタイムで返されます。

期限切れになったアクティベーションにも料金がかかりますか?

いいえ。20分以内に何も届かなかった場合、全額がウォレットに戻されます。

台湾の専用電話回線を取得できますか?

セルフサービスではできません。専用回線は米国とカナダのみで提供されており、台湾については確約なしでメールにてお問い合わせいただけます。

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