テストと運用のワークフローで Naver の SMS 認証コードを取得する

Naver は電話番号を何に使うのか？

Naver は韓国で圧倒的なシェアを持つウェブポータルで、1 つの Naver ID で Naver メール、ブログ、カフェ、Naver Pay、スマートストアの出品者ツールを利用できます。電話認証は、アカウント作成時、忘れた ID やパスワードの回復時、2 段階認証をオンにするとき、ログインが通常と異なると判断されたときなど、複数の場面で表示されます。韓国の居住者は、一部の機能について別の本人確認を求められることもありますが、それは SMS コードの対象外です。

メッセージは韓国語で書かれていることが多いため、テストでは固定の文面に一致させるのではなく、パターンで数字のコードを抽出してください。

Naver の電話番号ステップをテストするのは誰で、なぜか？

依頼の大半は 3 つのグループからです。自社のウェブアプリやモバイルアプリに Naver ログインを組み込む開発者は、リダイレクトや同意画面をテストするために実際のアカウントが必要で、そのアカウント作成には電話番号のステップを通過する必要があります。オンライン販売業者の運用スタッフは、誰の個人電話も使わずに、スマートストアのビジネスアカウントを認証します。ローカライズのテスターは、SMS ステップを含む韓国向けのオンボーディングフローの動作を確認します。アプリのサインアップ確認の一般的な進め方は、モバイルアプリ認証をご覧ください。

Naver の OTP を受信できるのはどの国か？

naver サービスは 198 か国で提供されています。例として、韓国、日本、米国、ベトナム、タイ、フィリピンのほか、台湾、インドネシア、マレーシア、モンゴル、カザフスタン、ウズベキスタン、カナダ、オーストラリア、ドイツ、英国などがあります。

認証するアカウントに合う国、またはテストケースが表す市場に合う国を選んでください。韓国の購入者向けのスマートストアのテストと、東南アジアのアプリ向けの Naver ログインのテストでは、必要なルートが異なり、送信元が外国の番号を国内の番号と異なる扱いにすることもあります。

Naver 認証コード API の流れは？

https://otproute.com/api/v1 に対して、Bearer キー（プレフィックス or_live_）を使います。GET /api/v1/prices?country=<id>&service=naver で費用を確認し、POST /api/v1/activations に {"service": "naver", "country": "kr"} のような本文を送って注文を作成します。レスポンスには電話番号とアクティベーション ID が含まれます。

Naver のフォームに番号を入力し、次の 2 つのいずれかの方法でコードを待ちます。

• Webhook：エンドポイントで activation.sms_received、activation.expired、activation.cancelled を購読します。X-OTPRoute-Signature（エンドポイントのシークレットによる <t>.<raw body> の HMAC-SHA256）を検証し、古いタイムスタンプは破棄し、アクティベーション ID をキーにしてハンドラーを冪等にします。
• ポーリング：1 分あたり 300 リクエストの上限内で、数秒おきに GET /api/v1/activations/{id} を呼び出します。

リクエストとレスポンスの詳細はドキュメントにあります。

Naver のコードが届かないのはなぜか、何が役立つか？

SMS が番号に届かない原因はいくつかあります。Naver が仮想と判断した番号帯を拒否した、特定の時間帯にルートが混雑していた、外国の番号に対して送信元の処理が遅かった、などです。有効時間は 20 分で、コードが実際に届いた場合にのみ課金されます。ウィンドウが空のまま終わった場合や POST /api/v1/activations/{id}/cancel を呼び出した場合は、全額がウォレットに戻ります。

落ち着いた再試行の計画が最も効果的です。

1. 失敗と判断する前に、ウィンドウが終わるまで待ちます。
2. 時間をおいて再試行するか、同じサービスで別の国のルートに切り替えます。
3. フォームが番号を国際形式の完全な形で送信しているか確認します。
4. 短い間隔での再注文は避け、試行の間隔をあけ、失敗を追跡できるようすべてのアクティベーション ID を記録します。

代わりにダッシュボードから Naver のコードを取得できるか？

はい。OTP Gateway を開き、Naver と国を選んで価格を確認し、注文します。Naver に番号を入力して SMS を要求すると、届いた時点でアクティベーションにコードが表示されます。この方法は、ビジネスアカウント 1 つを認証したい運用担当者に向いています。コードを書くほうが、作業そのものより時間がかかってしまうためです。

Naver には専用番号のほうが適しているのはどんなときか？

ワンタイム番号は、コードを 1 回受け取ると閉じます。後でアカウントの回復や新しい端末の確認を通過する必要がある場合には、それが問題になります。そのような場合は、米国またはカナダの専用番号（月額 $1.95 から）が、更新されている間ご自身のもとにあり、受信 SMS を number.sms_received として Webhook に転送します。詳細は仮想番号をご覧ください。

Naver のアカウントを責任を持って扱うには？

Naver の規約に従ってください。アカウントは実在する個人または事業者 1 つにつき 1 つとし、ご自身が所有するプロダクトや運用のために作成します。OTP Route は、自社の認証フローのテストと正当なアカウントの運用のために存在し、利用規約（Acceptable Use Policy）が適用されます。Naver はその所有者の商標であり、提携関係はありません。

よくある質問

API で Naver の OTP を受信するには？

サービス naver と選んだ国でアクティベーションを作成し、GET /api/v1/activations/{id} をポーリングするか、署名付きの activation.sms_received Webhook を待ちます。

Naver は仮想番号を受け付けますか？

常にではありません。Naver が一部の仮想番号を拒否することがあるため、何も受信しなかったアクティベーションは返金されます。

Naver の SMS が届かなかったらどうなりますか？

アクティベーションは 20 分後に閉じられ、全額がウォレットに戻ります。短い間隔で再注文するのではなく、時間をおくか、別の国のルートで再試行してください。

テスト用の Naver SMS 認証にはいくらかかりますか？

1 コード $0.20 からです。国ごとの正確な価格は API が最新の値を返し、ダッシュボードにも表示されます。

Naver の電話番号はどの国を選べばよいですか？

アカウントやテストケースの市場に合わせてください。たとえば、韓国向けのフローには韓国のルートを選びます。

同じ Naver の電話番号を後でもう一度使えますか？

ワンタイム番号では使えません。アカウントが今後もコードを必要とする場合は、米国またはカナダの専用番号が適しています。

お金をかけずに連携のリハーサルができますか？

はい。申請により、開発用アカウントをサンドボックスに切り替えられます。その場合は模擬の番号とコードが返されます。

Naver の認証の支払いはどうしますか？

1 つのプリペイド式 USD ウォレットに、カードまたは USDT/USDC でチャージします。月額料金はなく、チャージごとに PDF の請求書が発行されます。詳しくは料金をご覧ください。

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