+1 246番号でバルバドスの電話認証をテストする

なぜ +1 246 番号は電話番号バリデーションでつまずくのか

バルバドスは北米番号計画(NANP)に属しているため、国番号1をアメリカ、カナダ、カリブ海の多くの地域と共有しています。島を識別するのは市外局番246で、その後に7桁の加入者番号が続きます。E.164形式では +1246 に7桁を加えた形となり、プラス記号の後は合計11桁です。

エンジニアが陥りやすい落とし穴は、+1 をすべてアメリカとみなすコードです。この近道を取ると、国選択UIで誤った国旗が選ばれ、番号が誤ったマスクで整形され、ユーザーが米国専用の同意フローや料金体系に誘導されることもあります。地域は保守されている電話番号ライブラリで市外局番から判定し、スペースやハイフンのない正規のE.164文字列で保存し、整形は表示時だけにしましょう。バルバドス国内では7桁の市内番号だけをダイヤルすることも多いため、サインアップフォームはその入力も受け付け、保存前に補完するのが望ましいです。

公用語は英語なので、このルートの認証SMSは通常英語で届きます。

バルバドスのルートでチームが認証できるアプリは?

バルバドスの最新スナップショットには900を超えるサービスが掲載されています。人気のあるものは WhatsApp、Uber、Airbnb、Google (Gmail & YouTube)、Telegram、Facebook、Instagram、TikTok、Amazon、LinkedIn、Microsoft & Outlook、Signal、Netflix、eBay などです。

旅行、ホスピタリティ、配車系のプロダクトは、ここでテストする理由が特に大きい分野です。観光客向けのアプリは、予約やオンボーディングの際にカリブ地域の番号の確認を求めることがよくあるからです。提供状況は日中に変動するため、リストを固定値としてコードに埋め込まず、GET /api/v1/countries やダッシュボードから最新の内容を取得してください。

国 `bb` のAPIシーケンスは?

すべての呼び出しは https://otproute.com/api/v1 に対して行い、Developerコンソールで作成した or_live_ で始まるBearerキーを使用します。

1. GET /api/v1/prices?country=bb&service=<id> で最新の料金を取得します。
2. POST /api/v1/activations に {"service": "uber", "country": "bb"} のようなボディを送ってアクティベーションを作成します。
3. 返された +1 246 番号を、自社アプリの認証画面に入力します。
4. activation.sms_received Webhookを待つか、GET /api/v1/activations/{id} をポーリングします。
5. テストを中止する場合は POST /api/v1/activations/{id}/cancel を呼び出し、資金をすぐに戻します。

上限はアカウントあたり1分間に300リクエストです。リクエストの詳細な形式はAPIドキュメントにあり、署名の検証は別の記事で解説しています。

コードを書かない人でもバルバドスの認証番号を注文できますか?

はい。サインインして OTP Gateway を開き、バルバドスとサービスを選び、画面に表示された料金を確認して注文するだけです。番号はすぐに表示されるので、テスト中のアプリに貼り付ければ、コードが届いた時点で同じアクティベーションカードに表示されます。サポートや運用のスタッフはこの方法で作業し、エンジニアは同じルートを自動化していることが多いです。

コードが届きません。どうすればいいですか?

• 対応する前に20分の有効時間が終わるまで待ちましょう。遅れて届いたSMSも有効で、何も届かなければ自動的に返金されます。
• そのサービスが仮想番号を受け付けているか確認してください。仮想番号を即座に拒否するサービスもあり、だからこそ未使用のアクティベーションは返金されます。
• 少し時間を置いて再試行するか、テストの内容が許せば別のサービスのルートを使ってください。
• 短時間にループで注文を繰り返すのではなく、再試行の間隔を空けましょう。同じサービスへの連続した再試行はほとんど効果がありません。

配信失敗ガイドではさらに詳しく解説しています。

バルバドスの回線を長期間維持できますか?課金の仕組みは?

セルフサービスで利用できるバルバドスの長期番号はありません。専用番号(Dedicated Numbers)はアメリカとカナダ向けの製品で、月額 $1.95 からです。米国の回線は、同じ +1 で始まっていてもバルバドスの回線ではない点にご注意ください。長期の246番回線が必要な場合は [email protected] までメールでお問い合わせください。ただし、提供可否は現地の規則によるため、保証はできません。

バルバドスのコードにかかる費用は、前払い式のUSDウォレット1つから引き落とされます。サブスクリプションの階層はなく、月額請求もありません。カードまたはUSDT/USDCのステーブルコインで入金でき、経理担当者には入金ごとにPDFの請求書がメールで届きます。課金の仕組みは料金をご覧ください。このルートは、ご自身の正当なテストと業務にのみ使用してください。各サービスの利用規約と OTP Route の利用規定(Acceptable Use Policy)が適用されます。

よくある質問

現地SIMなしで、自社アプリのバルバドスのサインアップフローをテストできますか?

はい。OTP Gateway から +1 246 番号を注文し、アプリに入力して、ダッシュボードまたはWebhookでコードを読み取ってください。

OTP Route APIではバルバドスの国IDは何ですか?

バルバドスは bb です。POST /api/v1/activations の country フィールドと、料金のクエリで指定します。

バリデーターが +1 246 番号をアメリカの番号と判断することはありますか?

国番号だけを見ている場合はそうなります。共通の +1 番号計画の中で246はバルバドスに属するため、市外局番も確認してください。

バルバドスのSMSが届かなかった場合、料金は発生しますか?

いいえ。20分の有効時間内に何も届かずに終了した場合や、早めにキャンセルした場合は、サポートへの問い合わせなしで全額がウォレットに戻ります。

バルバドスの認証番号の料金はいくらですか?

1コード $0.20 からです。正確な金額はサービスによって異なり、注文前に GET /api/v1/prices で最新の値が返されます。

すべてのサービスがバルバドスの仮想番号を受け付けますか?

いいえ。仮想番号を拒否するサービスもあり、その場合コードが届かないことがあります。その際は返金で保護されるので、別のルートを試せます。

有料の本番番号を使う前に、バルバドスの連携をリハーサルできますか?

はい。ご依頼により、開発用アカウントをサンドボックスに切り替えられます。シミュレートされた番号とコードが返され、エンドツーエンドのテストが可能です。アカウントを作成して、サポートにお問い合わせください。

QA計画の中で、バルバドス向けのOTPルーティングはどのように位置づければよいですか?

自国市場と並ぶ、回帰テストスイート内の1つの国別ルートとして扱ってください。チームでの構成方法はQAテストのページをご覧ください。

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