チームの誰もボスニアのSIMを持っていないときに、+387のサインアップを検証する

リリースには+387のテストが必要なのに、SIMはサラエボの引き出しの中。どうする?

西バルカン向けに出荷するチームにとって、これはよくある悩みです。プロダクトマネージャーはボスニアのユーザーが登録できる証拠を求め、QAリードのチェックリストには「現地の番号で認証」という項目があるのに、実物の+387のSIMを持っているのは、去年の春に退職した同僚だけです。

チームがこの状況に陥る主な理由は次のとおりです。

• 地域リリース:ボスニア・ヘルツェゴビナをクロアチア、セルビア、モンテネグロと合わせて展開する場合、各市場のサインアップ経路を個別に確認する必要があります。
• ディアスポラの顧客:ドイツ、オーストリア、スウェーデンなどに住む多くの人が今も+387の番号を持っているため、フィンテックや通信周辺のプロダクトでは、オンボーディング中に一度も国に足を踏み入れていないユーザーからボスニアの番号が届くことがあります。
• ローカライズQA:ボスニア語、クロアチア語、セルビア語はいずれも公用語で、ラテン文字とキリル文字の両方が日常的に使われているため、文面とフォームのバリデーションは、実際にエンドツーエンドで確認する価値があります。

SIMカードを郵送し合う代わりに、OTP Route が OTPルーティングを担います。OTP Gateway は1回の認証用に+387番号を発行し、受信したSMSを、テスト環境から呼び出せるSMS認証APIを通じて返します。

ボスニアの認証番号にコードを送信できるアプリやプラットフォームは?

提供状況はライブのスナップショットなので、固定のメニューではなく出発点として捉えてください。執筆時点で、ボスニア・ヘルツェゴビナのルートには Viber、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Signal、Microsoft & Outlook、LinkedIn、Discord、Uber、Amazon、eBay などが含まれています。

この国には合計で1,600を超えるサービスがあります。ここに載っていないサービス向けのボスニア・ヘルツェゴビナ認証番号が必要な場合は、まず最新のリストを確認してください。バルカン半島では他の多くの地域よりViberの存在感が大きく、自社プロダクトがSMSだけでなくメッセージングチャネルでもコードを送る場合は、留意しておく価値があります。提供状況は日中に変動するため、テストスイートにリストをハードコードせず、APIで最新の選択肢を取得してください。

ボスニア・ヘルツェゴビナのOTP APIフローは、呼び出しごとにどう進む?

ボスニアのテストでは、クライアントを https://otproute.com/api/v1 に向け、or_live_ キーをBearerトークンとして渡します。キーはDeveloperコンソールで作成します。アカウントはキーを最大10個、Webhookエンドポイントを最大5個まで保持でき、上限は1分間300リクエストです。

1. GET /api/v1/services と GET /api/v1/countries を一度呼び出してIDをキャッシュし、ba が掲載されていることを確認します。
2. GET /api/v1/prices?country=ba&service=<id> で費用を確認し、支出の前に、ジョブが正確な金額をログに残すようにします。
3. POST /api/v1/activations に {"service": "<id>", "country": "ba"} を送ります。レスポンスには、アクティベーションIDと、テスト対象アプリに入力する+387番号が含まれます。
4. activation.sms_received Webhookを待ちます。ランナーが受信トラフィックを受け付けられない場合は、控えめな間隔で GET /api/v1/activations/{id} をポーリングします。
5. テストが中断した場合は POST /api/v1/activations/{id}/cancel で番号を解放し、資金をすぐに戻します。

Webhookでは、X-OTPRoute-Signature ヘッダー(t=<unix>,v1=<hex>)を読み取り、エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算し、定数時間で比較して、古いタイムスタンプは破棄してください。イベントはアクティベーションIDをキーにしているため、+387のコードが二重に配信されても、書き込みは一度だけにします。再試行とエラー処理のさらに詳しい解説はOTP API連携ガイドをご覧ください。

サポートや運用チーム向けのノーコードの方法はありますか?

はい。APIにアクセスできない人も、ブラウザから同じことができます。サインインして OTP Gateway を開き、ボスニア・ヘルツェゴビナとサービスを選び、料金を確認して確定します。番号が画面に表示され、SMSを受信するとその横にコードが表示されます。顧客の登録の問題を再現するサポート担当者や、電話番号の変更後にパートナーのポータルを確認する運用リーダーに向いています。

+387番号はどう保存し、ボスニアのSMS本文はどう解析すべき?

国内では、ボスニアの番号はトランクプレフィックスの 0 を付けてダイヤルし、携帯番号は通常 06 で始まります。E.164ではこのゼロは消えます。現地表記で061に6桁が続く番号は、+387 61 にその6桁を続けた形になります。保存するのはE.164形式のみとし、入力時にスペース、ハイフン、スラッシュを取り除き、国番号の後に先頭のゼロが残っているものは拒否してください。

認証SMSは英語または現地の言語のいずれかで届く可能性があり、キリル文字で書かれたメッセージも十分にあり得ます。特定の単語を探すのではなく、数字のパターンでコードを抽出し、デバッグで失敗した実行を調べるときに č、ć、š、ž などの発音区別符号が文字化けしないよう、ログでUTF-8が保たれるようにしてください。

テスト実行でコードが届かなかった場合は?

コードが届かなかった場合、料金は発生しません。20分以内にSMSが届かなかった場合、または先にキャンセルした場合は、全額が自動的にウォレットへ返金されます。そのような場合は、次の点を試してください。

• すぐに再注文せず、有効時間が終わるまで待ちましょう。遅れて届いたSMSも有効です。
• 少し時間を置いて再試行するか、同じシナリオで別のサービスのルートを選んでください。
• 対象のサービスが仮想番号を受け付けるか確認します。拒否するサービスもあり、返金はまさにそのために存在します。
• CIから短時間にループで注文するのは避けましょう。成功率は上がらず、レート制限を消費するだけです。

効果のあるパターンはOTP配信失敗を減らす方法にまとめています。

ボスニアの回線を長期間維持できますか?課金の仕組みは?

セルフサービスの製品としては提供していません。ウォレットから更新される専用仮想番号(Dedicated Virtual Numbers)は月額 $1.95 からで、アメリカとカナダでのみ即時販売しています。長期の+387回線が本当に必要な場合は [email protected] にメールでご連絡ください。可否は現地の規則によるため、手配できる保証はありません。

ゲートウェイの課金は、前払い式のUSDウォレット1つで行われ、月額料金も選ぶプランもありません。入金はカードまたはUSDT/USDCのステーブルコインで行え、入金ごとにPDFの請求書が受信トレイに届きます。連携作業には、ご依頼により開発用アカウントをサンドボックスに切り替えられ、シミュレートされた番号とコードが返るので、ウォレットの資金に触れずにパイプラインを実行できます。最新の料金は料金ページにあります。メールのコードまたはGoogleサインインでアカウントを作成できます。

よくある質問

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

はい。OTP Gateway でサービス用の +387 番号を注文し、アプリに入力して、ダッシュボードまたはAPIでコードを読み取ってください。

OTP Route ではボスニア・ヘルツェゴビナの国IDは何ですか?

IDは ba です。アクティベーションを作成するときは country フィールドとして、料金を確認するときは country クエリパラメータとして渡します。

+387のコードが届かなかった場合、支払いは発生しますか?

いいえ。20分の有効時間内に何も届かなかった場合、またはキャンセルした場合は、全額がウォレットに戻ります。

ボスニアの携帯番号を保存するとき、先頭のゼロは残すべきですか?

いいえ。番号はE.164形式、つまり国内のトランクゼロを除いた番号の前に +387 を付けた形で保存してください。

来月再びログインする必要があるアカウントに、テスト用の +387 番号は向いていますか?

あまり向きません。ゲートウェイの番号は1回の認証用だからです。繰り返しのログインには、アメリカまたはカナダの専用番号(Dedicated Number)がセルフサービスの選択肢です。ボスニアの長期回線については、チームにメールでお問い合わせください。

お金をかけずに、CIでボスニアのOTPテストを実行できますか?

はい。開発用アカウントでサンドボックスモードを依頼してください。シミュレートされた番号とコードが返るので、Webhookを含むフロー全体を無料で検証できます。

これらの番号の使い方に決まりはありますか?

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

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