QA・運用チームのためのナミビア(+264)SMS認証

なぜナミビアを独立した市場としてテストする価値があるのですか?

ナミビアは人口がまばらですが、複数のビジネスルートが交わる位置にあります。ウォルビスベイの港は内陸へ向かう貨物の玄関口となり、鉱業や観光が海外の事業者を引きつけ、多くの企業がこの国を、南アフリカやボツワナとともに、南部アフリカ全体への展開の一部として扱っています。

この組み合わせから、具体的なテストの必要が生まれます。

• 予約・旅行アプリは、旅行者や現地パートナーが +264 の番号で登録できることを確認する必要がある。
• ウィントフックや沿岸の町でドライバーや代理店をオンボーディングする物流プラットフォームは、電話番号のステップを最初から最後まで確認する必要がある。
• 地域の運用チームは、個人の電話に紐づけずにビジネスアカウントを認証したい。

いずれの場合も要件は限定的で、チームが所有するプロダクトまたはアカウントのための、ナミビアの番号での1回分の認証コードです。

ナミビアの番号はE.164でどう表記され、トランクの 0 はどう扱いますか?

国内では、番号は先頭にトランクの 0 を付けてダイヤルするため、携帯番号もその 0 を付けて書かれることがよくあります。国際形式では 0 が消え、+264 に国内有効番号が続く形になります。この市場で最もよくあるバグの原因が、この違いです。

データ層での実践ルール:

• ユーザーがすでに +264 を選択している場合は、先頭の 0 を1つ取り除き、+2640… が保存されないようにする。
• ユーザーごとに正規のE.164の値を1つだけ保持し、国内形式や国際形式はUIでのみ表示する。
• スペース、ハイフン、00264 のプレフィックスを含むケースでテストを実行し、正規化がこの3つすべてを捕捉することを確かめる。
• 桁数のルールは自作せず、保守されている電話番号ライブラリに任せる。

公用語は英語で、SMSテンプレートにも通常は英語が選ばれますが、アフリカーンス語、ドイツ語、オシワンボ語も広く話されています。プロダクトをローカライズしている場合は、メッセージが英語でなくても、自社のSMS文面とコードの抽出が引き続き動作することを確認してください。

今、ナミビアのルートで利用できるサービスは?

現在のスナップショットでは、ナミビア向けに800を超えるサービスが表示されています。一覧にある有名どころには、WhatsApp、Telegram、Google(Gmail & YouTube)、Facebook、Instagram、TikTok、X(Twitter)、Uber、Airbnb、Amazon、Discord、Microsoft & Outlook、ChatGPT(OpenAI)があります。

在庫は一日の中で変動するため、利用可否はリアルタイムで返されます。この一覧も含め、どの一覧も出発点として扱い、実行のたびにAPIに問い合わせてください。

運用担当者は、ダッシュボードで +264 のコードをどう取得しますか?

たまに行う認証であれば、連携は不要です。典型的なセッションは、数回クリックするだけで1〜2分で完了します。

1. ログインして OTP Gateway に進みます。
2. 国としてナミビアを、認証するサービスを選びます。
3. リアルタイムの料金を確認してから注文します。
4. +264 の番号をアプリの電話番号欄に貼り付け、SMSを発生させます。
5. 届いたら、アクティベーションからコードをコピーします。

定期的に行うQAの作業では、後述のAPIの方法を使うと時間を節約でき、すべてのアクティベーション ID の記録も残せます。

ナミビアのOTP APIでは、どの呼び出し順序を使いますか?

HTTP クライアントには、ベースURL https://otproute.com/api/v1 と、Developer console で発行する Bearer キー(or_live_ プレフィックスが目印)が必要です。ナミビアの国IDは na です。

IDは GET /api/v1/services と GET /api/v1/countries から取得し、GET /api/v1/prices?country=na&service=<id> でコストを確認し、テストスイートを開始する前に GET /api/v1/balance で残高を確認します。その後 POST /api/v1/activations に {"service": "telegram", "country": "na"} を送ると、番号とアクティベーション ID が返されます。

コードを取得するには、GET /api/v1/activations/{id} をポーリングするか、activation.sms_received と、その関連イベントである activation.expired と activation.cancelled の Webhook を登録します。X-OTPRoute-Signature ヘッダーは、エンドポイントのシークレットで <t>.<raw body> の HMAC-SHA256 を計算して検証し、タイムスタンプが古すぎるリクエストは拒否してください。アカウントはキーを最大10個、エンドポイントを5つまで保持でき、上限は1分あたり300リクエストです。APIリファレンス と、Webhook によるOTP取得 のウォークスルーをご覧ください。

なぜ +264 の番号にコードが届かないことがあるのですか?

サービスが仮想番号を拒否する場合、ルートが混んでいる場合、あるいは単に送信側の処理に時間がかかっている場合があります。アクティベーションの有効時間は20分で、課金されるのはコードが届いたときだけです。何も届かないまま時間切れになったとき、または POST /api/v1/activations/{id}/cancel でキャンセルしたときは、全額がウォレットに戻ります。

妥当な進め方は、有効時間が切れるまで待ち、時間をおくか別のサービスルートで再試行し、そのサービスが仮想番号を受け付けるかを確認し、ループで注文エンドポイントを連打しないことです。

ナミビアの番号を保持できますか?支払いの仕組みは?

OTP Route には、ナミビア向けのセルフサービスの長期番号はありません。専用回線は米国とカナダで、$1.95/月から、受信SMS、送信SMS、ブラウザー通話が付きます。+264 の恒久的な回線が必要なチームは [email protected] までご連絡ください。可能かどうかは現地の規制によります。

支払いは、1つの前払いUSDウォレットからの従量課金で、サブスクリプションも、選ぶべきプランもありません。カードまたは USDT/USDC でチャージでき、チャージごとにPDFの請求書が届きます。開発用アカウントでサンドボックスモードを依頼すれば、残高に触れずにシミュレートされたアクティベーションを実行できます。これらの番号は、自社のプロダクトとアカウントにのみ使用し、各サービスの利用規約と利用規定(Acceptable Use Policy)に従ってください。

よくある質問

APIでナミビアのSMS OTPコードを受信できますか?

はい。国 na とサービスIDでアクティベーションを作成し、そのアクティベーションをポーリングするか、署名付きの activation.sms_received Webhook を待ち受けます。

+264の番号は先頭にゼロを付けて保存すべきですか?

いいえ。トランクの 0 を除き、+264 に国内番号を続けたE.164形式で保存してください。

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

1コード $0.20 からです。各サービスの正確な金額は、注文前に表示されます。

SMSが時間内に届かなかったらどうなりますか?

コードが届かないまま20分が過ぎると、アクティベーションは終了し、課金額の全額がウォレットに戻ります。

現地に行かなくても、自社アプリのナミビア向けオンボーディングをテストできますか?

はい。OTP Gateway の番号を使えば、QAチームが自社アプリの電話番号ステップをリモートで実行できます。

月額プランは必要ですか?

いいえ。OTP Route は、カードまたはステーブルコインでチャージする前払いウォレットで動作し、月額料金はありません。

ナミビアの専用番号は利用できますか?

セルフサービスの製品としてはありません。長期回線は米国とカナダのみで販売されていますが、サポートにメールでお問い合わせいただくことはできます。

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