ネパールSMS OTPコードの受信:+977テストの準備・手順・対処法

事前準備:ネパールの番号をリクエストする前に何を用意すべきですか?

短い準備をしておくと、後で混乱しながらデバッグする手間を大幅に減らせます。最初の注文の前に、次のものがそろっているか確認してください。

1. 認証情報。 Developer console で or_live_ キーを生成し、Bearer トークンとして送信します。ローカル開発、CI、本番ツールで別々のキーを使うと、ローテーションが楽になります。
2. 国IDとサービスID。 ネパールは np です。サービスIDは GET /api/v1/services で調べます。
3. 資金またはサンドボックス。 GET /api/v1/balance を確認するか、開発用アカウントをサンドボックスに移してもらい、シミュレートされた番号とコードで連携を無料でテストします。
4. 配信方法の選択。 テストハーネスを書く途中ではなく、書き始める前に、Webhook エンドポイントとポーリングのどちらにするかを決めておきます。
5. Unicode対応の受信ビュー。 ネパール語のテンプレートからのコードはデーヴァナーガリー文字で届くため、ログがそれを正しく表示できるようにしておきます。

この仕組みに慣れていない場合は、OTPゲートウェイとは で、数分で背景がつかめます。

+977の回線にコードを配信できるアプリは?

現在、1,700を超えるサービスをネパールにルーティングできます。人気のものには、Viber、WhatsApp、Facebook、Instagram、TikTok、Telegram、Google(Gmail & YouTube)、Microsoft & Outlook、Discord、Signal、imo、Amazon、Claude があります。

この一覧はスナップショットであり、約束ではありません。可用性は一日の中で変わるため、GET /api/v1/prices?country=np&service=<id> は、テストで必要な組み合わせについて、リアルタイムの料金と可用性を返します。

ステップごとに解説:APIでネパールのSMS OTPを受信する

準備リストが完了したら、ネパールのOTP APIフローは最大でも5回の呼び出しで済みます。

1. np とサービスのリアルタイムの料金を確認します。
2. POST /api/v1/activations に本文 {"service": "<id>", "country": "np"} を送ってアクティベーションを作成します。返されたアクティベーション ID を保持してください。以降のすべての処理はこれをキーにします。
3. テスト中のフローに +977 の番号を入力し、SMSを発生させます。
4. activation.sms_received の Webhook からコードを取得するか、適度な間隔をおいて GET /api/v1/activations/{id} をポーリングします。
5. テストを途中で中止する場合は、POST /api/v1/activations/{id}/cancel でキャンセルします。

Webhook 側では、リクエストを信頼する前に X-OTPRoute-Signature を検証します。<t>.<raw body> を組み立て、エンドポイントのシークレットで HMAC-SHA256 の署名を行い、v1 と比較して、古いタイムスタンプは拒否します。その後、再配信されたイベントが害を及ぼさないよう、アクティベーション ID で upsert します。全体のパターンは、Webhook によるOTP取得 にあります。

コーディングよりクリックで済ませたい場合は、OTP Route のダッシュボードでネパールとサービスを選び、表示された料金を受け入れると、タイマー付きで番号が表示され、同じ画面にコードが現れます。

ネパールの携帯番号のフォーマット確認

ネパールの携帯番号は10桁で、9 で始まり、一般的には 98 または 97 です。国内では固定電話番号はトランクの 0 と市外局番を付けてダイヤルしますが、国際形式にはその 0 を含めません。したがって、テスト用のレコードは +97798xxxxxxxx のようになるはずです。

バリデーションテストで検証しておく価値があるのは次の点です。

• 先頭に 0 を付けて番号を入力したユーザーが、+977 の後ろでその 0 を取り除かれる。
• プレフィックスなしの10桁の携帯番号が受け付けられ、E.164に正規化される。
• ユーザーが連絡先カードから貼り付けるスペースやハイフンが、保存前に取り除かれる。

SMSの内容も確認が必要です。ネパール語はデーヴァナーガリー文字で書かれ、デーヴァナーガリー文字のメッセージはUnicodeとして送信されるため、1セグメントに入る文字数がラテン文字のテキストよりはるかに少なくなります。認証テンプレートをローカライズしている場合は、コードが1つのセグメントに収まり、周囲の言葉によって分割の境界を越えてしまわないか確認してください。多くのサービスは単に英語のテンプレートを送るので、両方をテストしましょう。

チームがネパール市場向けに開発・テストする理由

ネパールは、その規模以上に多くのプロダクトにとって重要です。ネパール人労働者の多くが海外で暮らしているため、湾岸諸国やマレーシアなどのコリドーに向けた送金、ウォレット、メッセージングのプロダクトは、いまも +977 の番号を持つユーザーを認証する必要がよくあります。ViberやWhatsAppなどのメッセージングアプリは、現地の日常的なコミュニケーションの一部です。

チームがテスト用に +977 の番号を注文するのは、次のような場合です。

• ネパール向けのサインアップフローを立ち上げ、国ピッカーに正しいマスクで国が表示されることを確かめる必要がある。
• オンボーディング画面とアカウント回復画面の、ネパール語の文字列を確認する。
• ログインコードが届かなかったという在外顧客からの報告を再現する。

アプリチームがこの種の国別カバレッジをどう構成しているかは、モバイルアプリ認証 のページで紹介しています。

トラブルシューティング:コードが届かなかった

コードが届かない原因にはいくつかの定番があり、その場で再注文することが解決策になることはまれです。

• まずは待つ。 アクティベーションの20分の有効時間を最後まで待つ。キューに入ったテキストが遅れて届くこともあります。
• 仮想番号のポリシー。 仮想番号を拒否するサービスがあります。その場合、アクティベーションは単に期限切れとなり、返金がウォレットに入ります。
• ルートの選択。 1つのルートを連打せず、後でやり直すか、同じサービスで別のルートを使う。
• レートの規律。 短いループで再注文すると、1分あたり300リクエストの上限を使い果たし、効果はほとんどありません。
• 自分のアプリ。 SMSの要求が実際に送信されたかを確認し、ログで送信リクエストをチェックする。

activation.expired イベントは、何も届かず、何も課金されなかったことを示すわかりやすい合図です。

長期回線と、ネパールルートの支払い

OTP Route は、セルフサービスのネパールの長期番号を提供していません。Dedicated Numbers は米国とカナダのみで、$1.95/月からです。チームが固定の +977 回線を必要とする場合は [email protected] にご連絡ください。手配できるかどうかは現地の規則によるもので、確約はできません。

支払いは、カードまたは USDT か USDC でチャージする1つの前払いUSDウォレットからの従量課金で、チャージごとにPDFの請求書がメールで届き、月額料金はありません。料金の表示方法は 料金ページ を、メールコードまたは Google でアカウントを作成するには サインアップ をご覧ください。

よくある質問

ネパールのSIMカードなしで、ネパールのOTPを受信できますか?

はい。OTP Gateway が1回の認証用に +977 の番号を発行し、コードはダッシュボードか API で読み取れます。

APIはネパールにどの国コードを求めますか?

料金とアクティベーションのリクエストでは、国として np を送信します。

ネパールの番号を保存するとき、先頭の 0 は残すべきですか?

いいえ。トランクの 0 は除き、+977 の後ろにE.164形式で保存してください。

ネパール語のコードは、ダッシュボードで正しく表示されますか?

メッセージは受信したとおりに表示されます。コードを確実に抽出できるよう、自分のログやテストのアサーションが、デーヴァナーガリー文字のテキストを扱えるようにしてください。

ネパールのコードが届かなかった場合、お金はどうなりますか?

何も課金されません。20分の間にSMSが届かなかったアクティベーション、またはキャンセルしたアクティベーションは、こちらから依頼しなくても、ウォレットに全額返金されます。

同じ +977 番号を、後のログインにも使えますか?

いいえ。各 OTP Gateway の番号は1回のコード用です。後で再びログインが必要なアカウントには Dedicated Number が適していますが、提供されるのは米国とカナダのみです。

ネパールの認証番号の利用に関するルールはありますか?

はい。各サービスの利用規約と利用規定(Acceptable Use Policy)を守り、番号は自社の正当なプロダクトとアカウントのテストや運用にのみ使用してください。

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