ロックで開発・運用するチームのための +350 番号の認証

ジブラルタルのチームが解決しようとしている問題は何か？

ジブラルタルは、規制対象のオンラインビジネスで、その規模をはるかに超える存在感があります。リモートゲーミング事業者、決済企業、金融サービス企業が、大きなチームを置いています。これらのプロダクトはオンボーディングが厳格で、コンプライアンスを重視する QA リードは、+350 の携帯を持つ顧客が登録、ステップアップログイン、復旧を通過できる証拠を求めます。

問題を複雑にしているのは、従業員の構成そのものです。スタッフの多くは国境を越えたスペインに住み、スペインの SIM を持っているため、テストの実行ごとにジブラルタルの端末を探すのは面倒で、誰かの私用の電話を使うと、ビジネスアカウントが 1 人の個人に結びついてしまいます。OTP Gateway のジブラルタル認証番号なら、必要な 1 コードごとに、その依存をなくせます。

+350 番号の形式と、バリデーターがつまずく点は？

ジブラルタルは、トランクプレフィックスのない、8 桁のクローズド番号計画を使っています。そのため、住民が国内でダイヤルする数字は、国際形式で +350 の後に続く数字と同じです。携帯番号は通常 5 で始まり、固定回線は 200 で始まります。

これほど単純でも、つまずく人はいます。

• +350 に 8 桁を足した形だけを保存し、保存前にスペースを取り除く。
• 先頭の 0 を足したり削ったりしない。英国やスペインと違い、ここには扱うべき 0 がありません。
• 隣のスペイン市場向けに調整された、9 桁を期待するバリデーターを避ける。
• 国選択はスペインのエントリーと分けておく。利用者は日々両国を行き来し、両方の番号を持っていることもあります。

公用語は英語ですが、スペイン語も広く話されているため、アプリはアカウントや端末の設定によって、どちらの言語でもコードを送る可能性があります。テンプレートをローカライズしている場合は、両方のバージョンをテストしてください。

ジブラルタルのルートで到達できるサービスは？

現在のライブリストには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、LinkedIn、X (Twitter)、ChatGPT (OpenAI)、Claude、Microsoft & Outlook、Amazon、Discord、Signal、Uber など、合計 1,200 を超えるサービスが含まれます。提供状況は一日の中で入れ替わるため、API は固定のカタログではなく、問い合わせた瞬間の提供状況を返します。

ジブラルタルで特定のサービスが見つからない場合、+350 のプレフィックスが厳密に必要ないテストであれば、スペインや英国といった近隣のルートが適している場合があります。

API でジブラルタルの OTP 取得を自動化するには？

ジブラルタルの OTP API は、他の国と同じ REST インターフェースで、変わるのは ID gi だけです。開発者コンソールで or_live_ プレフィックスのキーを作成し、次のように進めます。

1. GET /api/v1/services と GET /api/v1/countries で、提供されているものを一覧します。
2. GET /api/v1/prices?country=gi&service=telegram で、その組み合わせの価格を確認します。
3. POST /api/v1/activations にボディ {"service": "telegram", "country": "gi"} を送って注文します。
4. 登録済みの Webhook で activation.sms_received を受信するか、適切な間隔をあけたポーリングループで GET /api/v1/activations/{id} を読み取ります。
5. activation.expired と activation.cancelled も待ち受け、テストランナーがケースをきれいに終了できるようにします。

すべての配信を検証するため、エンドポイントのシークレットを使って "<t>.<raw body>" の HMAC-SHA256 を再計算し、X-OTPRoute-Signature と照合し、古いタイムスタンプは破棄してください。1 アカウントの上限は、キー 10 個、Webhook エンドポイント 5 個、1 分あたり 300 リクエストです。パイプラインに組み込むチームは、CI での SMS OTP テストの記事を参考にしてください。

API を使わない人のためのダッシュボードの手順は？

コンプライアンス担当者やアカウントマネージャーは、ブラウザーからジブラルタルの SMS OTP を受信できます。ログインして資金を追加し、OTP Gateway でサービスとジブラルタルを選び、表示された価格を確認して確定します。番号を対象のアプリに入力し、注文を見守ります。サービスが送信すると、コードがそこに届きます。

番号は 20 分間確保され、コードは 1 件を扱います。課金されるのは、そのコードが届いたときだけです。何も届かないまま期限が切れた場合や、手動でキャンセルした場合は、金額がウォレットに戻ります。

+350 のコードが表示されないのはなぜか？

小さな市場にはキャリアの経路が少なく、仮想番号の範囲を選別するサービスもあります。何も表示されない場合は、次を試してください。

• 1 分でキャンセルするのではなく、有効期間が終わるまでアクティベーションを開いたままにする。
• 再試行の前に待ち、その後に時間をおいて、または別のサービスルートを試す。立て続けの再注文は、フィルタリングを悪化させがちです。
• アプリが仮想番号を明確に拒否していないか確認する。拒否している場合は、返金でその試行がカバーされるので、別の方法でテストしてください。
• フロントエンドが、国番号の後の 8 桁すべてを送信したか確認する。

ルートの選択が結果にどう影響するかは、OTP の国別ルーティングの解説をご覧ください。

ジブラルタルの番号を長期で保持できるか。支払いはどうなっているか？

セルフサービスで取得できるジブラルタルの長期番号はありません。月額 $1.95 からの専用番号（Dedicated Numbers）は、米国とカナダのみで販売されています。運用チームが長期の +350 回線を必要とする場合は、[email protected] にメールしてください。回答は現地の規制によるため、難しい場合もあります。

それ以外はすべてプリペイドの USD ウォレットで動きます。サブスクリプションはなく、チャージはカードまたは USDT/USDC、支払いごとに PDF 請求書がメールで届くため、規制の厳しい企業の経理担当者にも便利です。開発用アカウントでサンドボックスモードを依頼すれば、シミュレートされた番号とコードを、費用をかけずに連携へ流せます。現在の料金は料金ページに掲載されています。

よくある質問

ジブラルタルにいなくても、ジブラルタルの認証コードを受信できますか？

はい。OTP Gateway が、どこからでも使える +350 番号を発行し、コードはダッシュボードまたは Webhook に届きます。

ジブラルタルの番号には、英国の先頭の 0 のようなトランクプレフィックスがありますか？

いいえ。ジブラルタルはトランクプレフィックスのない 8 桁の番号を使うため、+350 の後の数字は国内でも国際でも同一です。

ジブラルタルには、どの API の国 ID を使いますか？

価格の照会と POST /api/v1/activations の country の値として gi を渡します。

テスト用の +350 番号はいくらですか？

1 コード $0.20 からで、正確な料金はサービスによります。API とダッシュボードのどちらでも、購入前に確認できます。

アプリのコードがジブラルタルの番号に届かなかった場合はどうなりますか？

SMS が届かないまま 20 分が過ぎると、アクティベーションは期限切れとなり、全額が自動的にウォレットに戻ります。

コードは英語とスペイン語のどちらで届きますか？

送信するサービスによります。アカウントや端末の言語を使うものが多いため、ローカライズしたフローは両方でテストする価値があります。

この番号は、どんな種類のアカウントにも使えますか？

正当なテストと、自社のビジネスアカウントにのみ使えます。各サービスの利用規約と、OTP Route の利用規定（Acceptable Use Policy）に従ってください。

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