ベトナム(+84)の認証コードを、そのままテストスイートへ

ベトナムで実際の+84経路をテストする価値はどこにありますか?

ベトナムはモバイルファーストの市場で、チャット、ソーシャルコマース、スーパーアプリ型のサービスが日常生活の中心にあります。現地で広く使われているメッセンジャーはZaloで、ShopeeやLazadaなどのマーケットプレイスも広く知られています。プロダクトチームがここでテストを行うのは、ベトナム版のビルドを公開するとき、ベトナム語のオンボーディングを検証するとき、東南アジア拠点から地域全体の顧客をサポートするときです。こうしたテストがリリースサイクルにどう組み込まれるかは、モバイルアプリ認証のページで説明しています。

ベトナムの携帯番号はどのような形式ですか?

国内では、携帯番号は先頭にトランクの0を付け、全体で10桁で表記し、03、05、07、08、09などの接頭辞で始まります。2018年に、従来の11桁の携帯番号が10桁に移行されたため、古いCRMデータには旧式の接頭辞が残っている場合があります。

保存時は0を外し、E.164形式の+84に9桁を続けた形にします。入力時に正規化し、表示用の整形は別に行ってください。

ベトナム語には声調記号があり、送信元はSMSを短くするためにそれを省くことが多いため、コードが声調記号なしのベトナム語や英語で届くこともあります。いずれの場合でもパーサーが数字を抽出できることをテストしてください。

ベトナム経路ではどのサービスに到達できますか?

現在、ベトナムでは2,800を超えるサービスが掲載されています。リクエストの多いものとして、Zalo、Shopee、Lazada、TikTok、Facebook、Telegram、WhatsApp、Google(GmailとYouTube)、Instagram、MicrosoftとOutlook、Amazon、ChatGPT(OpenAI)、Discord、Viberなどがあります。対応状況は一日を通して変化するため、決め打ちせずにリアルタイムで確認してください。

ベトナム向けのQAでは実際に何を確認すべきですか?

コードを受信するだけでなく、有用な+84のテスト実行では、この市場でオンボーディングが壊れやすい箇所を確認します。

• 電話番号欄が、09…の国内形式の入力と+84 9…の国際形式の入力の両方を受け付け、同じ値として保存すること。
• ベトナム語版のビルドで、国選択欄がViệt Namを声調記号も含めて正しく表示すること。
• 周囲の文章に声調記号がなくても、AndroidとiOSのOTP自動入力が数字を拾えること。
• コードの誤りや期限切れを知らせるエラー文が、直訳ではなく自然なベトナム語になっていること。
• 再送ボタンの待機時間が十分長く、配信が遅れた場合に2回目のリクエストに追い越されないこと。

SMS層をモックにせず実際の経路に対してこれらを実行すれば、ハノイやホーチミン市のお客様に見つかる前に、書式や解析のバグを捕まえられます。

ベトナムのOTP APIはエンドツーエンドでどのように動作しますか?

リクエストはhttps://otproute.com/api/v1に、Bearerキー(プレフィックスor_live_)を付けて送信します。ベトナムの国IDはvnです。

1. GET /api/v1/prices?country=vn&service=zaloを呼び、価格と提供状況を確認します。
2. POST /api/v1/activationsにボディ{"service": "zalo", "country": "vn"}を送って番号を確保し、返されたアクティベーションIDを保持します。
3. 返された+84の番号を、アプリの認証画面に入力します。
4. Webhookでactivation.sms_receivedを受け取るか、GET /api/v1/activations/{id}を数秒おきにポーリングします。
5. 不要になったアクティベーションはPOST /api/v1/activations/{id}/cancelで終了します。

各Webhookは、信頼する前にX-OTPRoute-Signatureを検証してください。CIの完全な設定については、CIパイプラインでのSMS OTPテストをご覧ください。

開発者以外でも+84の番号を注文できますか?

はい。ダッシュボードでベトナムとサービスを選び、表示された価格を確認して確定し、番号をアプリに貼り付けます。コードはアクティベーションカードに表示されます。20分以内に何も届かない場合、またはキャンセルした場合は、金額がウォレットに返金されます。

OTP Routeはベトナムの長期番号を販売していますか?

いいえ。セルフサービスの専用バーチャル番号は、米国とカナダのみで、月額$1.95からです。ベトナムでは、OTP Gatewayの各番号が受信できるコードは1回分だけです。+84の固定回線をご希望のチームは、[email protected]にメールでお問い合わせください。ただし、可否は現地の規制によって決まります。両方のモデルはバーチャル番号のページで比較できます。

+84のテスト費用はどのように支払いますか?

ベトナムでのアクティベーションは、他の経路と同じプリペイド式のUSDウォレットから引き落とされ、月額料金や選ぶべきプランはありません。入金にはカード決済とUSDT/USDCのどちらも使え、入金のたびに経理チーム向けのPDF請求書がメールで届きます。開発用アカウントでサンドボックスモードを申請すると、ウォレットの費用をかけずに、模擬の番号とコードで連携を一通りテストできます。

よくある質問

現地のSIMを買わずに、アプリのベトナム向け新規登録をテストできますか?

はい。OTP Gatewayで+84の番号を注文し、ご自身の登録フローに入力すれば、コードをダッシュボードまたはAPIで確認できます。

ベトナムの番号は先頭の0を付けて保存すべきですか?

いいえ。+84に続けて9桁の形で保存し、国内形式で表示するときだけ0を戻してください。

古い顧客データに11桁のベトナムの携帯番号があるのはなぜですか?

ベトナムは2018年に11桁の携帯番号を10桁に変更しました。変更前に取得したレコードは、現在の接頭辞への移行が必要な場合があります。

ベトナムの認証メッセージには声調記号が含まれますか?

含まれないことが多いです。多くの送信元がSMSから声調記号を取り除くためです。コードのパーサーは、周囲の文言ではなく数字に基づくようにしてください。

ZaloやShopeeのコードが+84の番号に届かない場合はどうすればよいですか?

自動返金されるよう、アクティベーションを20分間の有効時間いっぱいまで開いたままにしてから、後で再試行するか別の経路に切り替えてください。仮想番号を拒否するサービスもあり、短時間に繰り返し注文しても効果は期待できません。

ベトナム経路は何件のサービスに対応していますか?

現時点で2,800件を超えます。最新の一覧は、GET /api/v1/servicesと、国IDvnに対するGET /api/v1/pricesで取得できます。

OTP Routeの+84番号は、すべてのアプリで使えますか?

いいえ、受け付けられる保証はありません。仮想番号の扱いは各サービスが独自に定めているためです。課金されるのは、コードが配信されたときだけです。

ベトナムの番号には、どのような利用ルールが適用されますか?

ご自身のプロダクトと事業用アカウントの認証にのみ使い、各サービスの規約を守り、OTP Routeの利用規定(Acceptable Use Policy)の範囲内でご利用ください。アカウントの大量作成や重複作成は禁止されています。

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