ベラルーシの+375認証コードを受信するための事前チェックリスト

+375番号をリクエストする前に、何を整えておくべき?

テストに+375番号を使う前に、次を確認してください。

• アカウントとチャージ済みのウォレット。 メールアドレスと6桁のメールコード、またはGoogleサインインでサインアップしてアカウントを作成し、少額の残高を追加します。APIキーを持つアカウントには、TOTP二要素認証を有効にしてください。
• or_live_ プレフィックスのBearerキー。 Developerコンソールで作成します。CIとローカル開発には別々のキーを割り当ててください。1アカウントに最大10個持てます。
• 送信する2つのID。 APIでのベラルーシは by で、サービスIDは GET /api/v1/services が返す api_service の値です。
• Webhookを使う場合の受信エンドポイント。 署名シークレットはリポジトリの外に保管します。
• 電話番号の変更や追加が許可されている、自社プロダクトのテストアカウント。
• リージョンBYに設定した電話番号ライブラリ。 登録フォームに貼り付ける番号が、実際のベラルーシのユーザーが入力するとおりに解析されるようにします。

ベラルーシの番号はどう書かれ、アプリはどう保存すべき?

ベラルーシの国番号は+375で、その後に9桁の国内番号が続きます。携帯回線は25、29、33、44といった事業者コードで始まるため、保存される値は +37529XXXXXXX のようになります。

厄介なのは国内の習慣です。国内の人は携帯番号を、長距離ダイヤルのプレフィックスに由来する先頭の 80 を付けて、8 029 XXX-XX-XXのように書くことがよくあります。国番号を付ける前にこの 80 を取り除く必要があります。残したままのフォームは無効なE.164文字列を生成し、一部の認証サービスは何も言わずに拒否します。ベラルーシの認証用番号に対する、よい正規化テストは次のとおりです。

• +375 29 ...、375 29 ...、8 029 ... を受け付け、3つとも同一に保存する。
• 表示は現地になじむグループ化にするが、SMSや認証のレイヤーにはE.164のみを送る。
• 375 の後ろにまだ 80 が残っている番号を拒否する。

ベラルーシ語とロシア語の両方が公用語で、日常的に使われているのはロシア語です。アカウントのロケールに応じて、ロシア語または英語でコードの文面を送るサービスが多いため、メッセージをそのまま表示する画面では、アプリがキリル文字を正しく表示するか確認してください。

ベラルーシの認証用番号でコードを受信できるサービスは?

OTP RouteでのベラルーシのOTPルーティングは、現在ID by で1,400を超えるサービスに対応しています。現在のスナップショットで人気のルートには、Telegram、Viber、WhatsApp、Signal、Google (Gmail & YouTube)、Instagram、TikTok、Microsoft & Outlook、LinkedIn、Discord、Amazon、AliExpressがあります。

個々のルートの空き状況は日中に変動するため、このような一覧は保証ではなく出発点として扱ってください。実行の前に GET /api/v1/prices?country=by&service=<id> で、現在の価格と、そのルートが今注文を受けられるかを確認してください。国を選ぶときは、OTPの国別ルーティングを参照してください。

手順:テストスクリプトからのベラルーシOTP APIフロー

すべてのリクエストは、Bearerキーを付けて https://otproute.com/api/v1 に送ります。SMS認証APIは小さいため、1つのヘルパーにまとめられます。

1. GET /api/v1/balance を呼び出し、スイートに対してウォレットが不足していれば、ジョブを早めに止めます。
2. GET /api/v1/prices?country=by&service=telegram(サービスIDは自分のものに置き換え)を呼び出し、これから支払う価格をログに残します。
3. POST /api/v1/activations に、{"service": "telegram", "country": "by"} のようなボディを送って注文を作成します。レスポンスから、アクティベーションIDと+375番号を保存します。
4. その番号を自社アプリの電話番号ステップに送信し、コードを発生させます。
5. activation.sms_received イベントからコードを取得するか、GET /api/v1/activations/{id} をポーリングします。上限は毎分300リクエストです。
6. テストが中止された場合は、POST /api/v1/activations/{id}/cancel を呼び出し、保留分をすぐにウォレットへ戻します。

Webhookでは、X-OTPRoute-Signature ヘッダー(t=<unix>,v1=<hex>)を読み取り、エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算し、定数時間で比較し、古いタイムスタンプの配信は破棄します。ハンドラーをアクティベーションIDで管理すれば、繰り返された配信も無害です。詳細はAPIドキュメントと、HMACでOTP Webhookを保護するガイドで説明しています。

手順:同じ作業をダッシュボードから行う

たまにコードが必要になるサポート担当者は、APIを使わずに済ませられます。

1. ダッシュボードでOTP Gatewayを開き、ベラルーシを選びます。
2. サービスを選びます。確定する前に、そのルートの価格が表示されます。
3. +375番号をコピーして、テスト対象のアプリに入力します。
4. 注文カードを見守ります。コードは届いた瞬間にそこへ表示されます。

20分以内に何も届かない場合、注文は終了し、全額が払い戻されます。お支払いいただくのは、コードが配信されたときだけです。

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

よくある原因と、それぞれの次の一手です。

• サービスが番号を拒否した。 仮想番号を拒否するプラットフォームもあります。返金ルールはまさにこのケースのためにあります。テストが許せば、別のサービスルートまたは別の国を試してください。
• 番号が国内形式で入力された。 フォームが、80 なしで +375 に9桁を続けた形で送信しているか再確認してください。
• ルートが混み合っている。 1分後にキャンセルせず、有効時間を最後まで待ってから、後でもう一度試してください。
• スクリプトが短い間隔のループで再注文している。 試行の間にバックオフを入れてください。1つのサービスへの急な再注文はほとんど効果がなく、対象プラットフォームに不正利用に見えることもあります。

+375の注文に関するその他の失敗パターンは、OTP配信失敗を減らすで扱っています。

ベラルーシの長期回線はある?課金の仕組みは?

いいえ。OTP Routeには、ベラルーシ向けのセルフサービスの長期番号はありません。運用やサポート用途でチームが必要とする場合は、[email protected] にメールで内容をお知らせください。何を提供できるかは現地の規制によるため、確約はありません。専用仮想番号(Dedicated Virtual Numbers)は米国とカナダ向けの製品で、受信SMS、送信SMS、ブラウザ通話を備え、月額$1.95からです。

ベラルーシの注文は、他のすべてのルートと同じ前払い式のUSDウォレットから引き落とされ、月額料金も、選ぶプランもありません。カードまたはUSDT/USDCのステーブルコインでチャージでき、チャージごとのPDF請求書が受信トレイに届きます。開発者は、シミュレートされた番号とコードを返すサンドボックスアカウントを依頼できます。本番の注文の前に連携を確かめる、最も安い方法です。番号はすべて、自社の製品または自社の正当なアカウントにのみ使用し、各サービスの利用規約を守り、OTP Routeの利用規定(Acceptable Use Policy)が適用されることにご留意ください。現在の金額は料金にあります。

よくある質問

現地SIMなしで、自社アプリのベラルーシ向け登録フローをテストできますか?

はい。OTP Gatewayで自社サービス用の+375番号を注文し、登録フォームに送信して、ダッシュボードまたはAPIでコードを読み取ってください。

OTP Route APIでのベラルーシの国IDは何ですか?

by です。GET /api/v1/prices と、POST /api/v1/activations のボディで使用します。

ベラルーシの番号を、80プレフィックス付きで保存すべきですか?

いいえ。E.164で+375に9桁を続けた形で保存し、国内の 80 は取り除いてください。残すと、多くのサービスがその番号を無効として扱います。

+375番号にコードが届かなかった場合、お金はどうなりますか?

SMSが届かないまま20分の有効時間が終了した場合、またはキャンセルした場合は、全額が自動的にウォレットへ戻ります。

認証SMSは何語で届きますか?

送信するサービスが決めます。ベラルーシの番号の場合、アカウントや端末の言語に基づいて、ロシア語または英語であることが一般的です。

将来のログイン用に、+375番号を保持できますか?

セルフサービスではできません。長期の専用番号(Dedicated Numbers)は米国とカナダのみです。ベラルーシについては [email protected] にメールで問い合わせられますが、提供できる保証はありません。

ウォレット資金を使わずに連携をテストする方法はありますか?

はい。リクエストにより開発アカウントをサンドボックスに切り替えられ、エンドツーエンドのテスト用にシミュレートされた番号とコードが返ります。

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