チームの誰もベリーズのSIMを持っていないとき、+501のサインアップフローをテストする方法

リリースには+501のコードが必要なのに、ベリーズのSIMを持つ人がいない

よくある状況です。中米向けのロールアウトが予定され、QA計画にもベリーズが載っているのに、ベリーズの携帯電話を持っているのはお客様だけ。同僚の個人番号を借りるのは気が引けますし、テストサイクルごとに繰り返せるものでもありません。

OTP Route が解決するのは、その問題のうち限られた部分です。OTP Gateway は、選択したサービスで1回の認証コードを受け取るための+501番号を発行し、そのコードをお客様に返します。自社のサインアップ画面やログイン画面を確認するチームのために作られたOTPルーティングで、QAテストのワークフローにも自然に組み込めます。

ベリーズの電話番号で間違えやすい点は?

ベリーズの番号は短めです。国番号+501の後に7桁の国内番号が続き、トランクプレフィックスはないため、国内表記とE.164形式の違いは先頭の+501だけです。先頭の0や10桁の国内番号を前提に書かれたバリデーターは、有効なベリーズの入力を拒否しがちなので、専用のテストケースを用意する価値があります。

番号は+501と7桁で保存し、保存前に書式文字を取り除き、現地のグループ分けはUIでの表示時だけに適用してください。公用語は英語ですが、スペイン語とベリーズ・クリオール語も広く話されています。認証SMSは通常英語で届きますが、スペイン語のテンプレートの可能性もあるため、コードは数字のパターンで抽出しましょう。

ベリーズは中米で唯一、英語が公用語の国でもあります。そのため、地域向けに1つのフローを英語とスペイン語の両方へローカライズするチームにとって、手頃なチェックポイントになります。

APIでベリーズの認証番号を取得するには?

https://otproute.com/api/v1 へのすべての呼び出しは、Developerコンソールで作成した or_live_ で始まるBearerキーで認証します。

1. GET /api/v1/services と GET /api/v1/countries でカタログを取得します。ベリーズは bz です。
2. GET /api/v1/prices?country=bz&service=<id> で、最新の料金と提供状況を確認します。
3. POST /api/v1/activations に {"service": "whatsapp", "country": "bz"} を送って注文します。
4. 返された+501番号をアプリに入力します。
5. 署名付きWebhookで activation.sms_received を待つか、GET /api/v1/activations/{id} をポーリングします。早めに止めるには POST /api/v1/activations/{id}/cancel を使います。

Webhookリクエストには X-OTPRoute-Signature ヘッダーが付きます。<t>.<raw body> に対するHMAC-SHA256を検証し、古いタイムスタンプは拒否してください。リクエストとレスポンスの詳細は開発者向けドキュメントに記載されています。

+501番号にコードを送信できるアプリは?

現在、ベリーズのルートでは900を超えるサービスが利用できます。特にリクエストが多いのは WhatsApp、Facebook、Google (Gmail & YouTube)、Airbnb、Instagram、TikTok、Telegram、Uber、Amazon、eBay、Microsoft & Outlook、Signal、Snapchat などです。

提供状況は日中に変わるため、これはスナップショットとして捉え、現時点で使えるものは料金エンドポイントまたはダッシュボードで確認してください。

コーディングより操作派なら、ダッシュボードで

サポート担当者やプロダクトマネージャーはAPIを使う必要が全くありません。サインインし、サービスを選び、ベリーズを指定し、料金を確認して確定するだけです。+501番号が画面に表示されるので、確認したいアプリに貼り付ければ、コードが届いたときに注文の横に表示されます。キャンセルボタンを押すと注文を早めに終了でき、代金も戻ります。

コードが遅い、または届かない場合は?

所要時間はサービスとルートによって決まり、こちらで調整できるものではありません。コードが届かないときは、次の点を試してください。

• 注文はそのままにしておきましょう。有効時間は20分で、期限切れまたはキャンセルされた注文は全額返金されます。
• 少し間を置いて再試行するか、テストの内容が許せば別のサービスのルートを使ってください。
• そのステップでサービスが仮想番号を受け付けるか確認します。拒否するサービスもあり、その場合は返金で保護されます。
• 注文エンドポイントをループで連打せず、自動化ジョブでは再試行の間隔を空けてください。

+501の回線を長期間維持できますか?支払いの仕組みは?

セルフサービスで利用できるベリーズの長期番号はありません。月額 $1.95 からの専用番号(Dedicated Numbers)はアメリカとカナダ向けのみです。ベリーズの回線を継続して必要とする場合は [email protected] までご連絡ください。ただし、提供可否は現地の規則によります。どちらが適しているかは、一時番号と専用番号の比較で解説しています。

支払いは前払い式のUSDウォレットによる従量課金で、月額料金はありません。カードまたはUSDT/USDCで入金すると、入金のたびにPDFの請求書がメールで届きます。開発用アカウントをサンドボックスに切り替えるようサポートに依頼すれば、APIがシミュレートされた+501番号とコードを返すので、CIで全工程を無料で検証できます。サインアップは、メールと6桁のコード、またはGoogleで行えます。

よくある質問

ベリーズにいなくても、ベリーズのSMS OTPコードを受信できますか?

はい。+501番号は OTP Gateway から発行され、チームの所在地に関係なく、ダッシュボードまたはAPIでコードを読み取れます。

ベリーズの電話番号は何桁ですか?

国内番号は7桁でトランクプレフィックスはなく、国際表記では+501の後にその7桁を続けます。

OTP Route APIでのベリーズの国IDは何ですか?

POST /api/v1/activations などの呼び出しでは bz を使用します。

ベリーズのコードが届かなかった場合、料金はどうなりますか?

何も差し引かれません。SMSが届かないまま20分の有効時間が終了した場合、またはキャンセルした場合は、全額がウォレットに返金されます。

毎週ログインするアカウントに、ベリーズの認証番号は向いていますか?

あまり向きません。OTP Gateway の番号は1回のコード用だからです。繰り返しログインする場合は、アメリカまたはカナダの専用番号(Dedicated Number)がセルフサービスの選択肢です。

+501番号で認証できる対象に決まりはありますか?

はい。ご自身の正当なプロダクトとアカウントにのみ使用し、各サービスの利用規約を守ってください。OTP Route の利用規定(Acceptable Use Policy)も適用されます。

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