+226宛てサインアップのテスト:ブルキナファソ認証番号チェックリスト

+226番号を依頼する前に、何を準備しておくべきですか?

初回の失敗の多くは、ルートそのものではなく準備不足が原因です。最初の注文の前に、次の項目を確認してください。

• APIキー。 開発者コンソールで作成します。本番キーのプレフィックスは or_live_ で、Bearerトークンとして送信します。キーは最大10個まで保持できるので、ステージング用とCI用は分けておきましょう。
• チャージ済みのウォレット。 カードまたはUSDT/USDCで入金できます。コードが届かなかった分は課金されません。
• 正しいID。 APIでのブルキナファソは bf です。サービスIDは推測せず、GET /api/v1/services で確認してください。
• 受信方法の計画。 シークレットを安全に保管したWebhookエンドポイントか、適切な間隔を置いたポーリング処理のどちらかを用意します。1アカウントで最大5つのWebhookエンドポイントを登録できるため、ステージングと本番を分けるのに便利です。
• 正当な認証対象のアカウント。 自社プロダクトのテストユーザー、またはチームが運用する業務用アカウントが対象です。各サービスの利用規約とOTP Routeの利用規定(Acceptable Use Policy)が適用されます。

コードを書く前に全フィールドを確認したい場合は、APIリファレンスをご覧ください。

ブルキナファソのルートでコードを受け取れるアプリは?

bf のライブカタログには、現在900を超えるサービスが掲載されています。執筆時点で利用できる主なサービスは、WhatsApp、Facebook、Instagram、TikTok、Telegram、Google (Gmail & YouTube)、Microsoft & Outlook、imo、Viber、Signal、LinkedIn、Uber、Amazon、ChatGPT (OpenAI)などです。

提携キャリアが回線容量を増減させるため、利用可否は一日の中で変わります。この一覧はあくまでスナップショットとして扱ってください。注文の直前に GET /api/v1/prices を呼び出すようにコードを組むと、現在の価格と、その組み合わせが注文可能かどうかが返ってきます。

国ID `bf` のAPIシーケンスはどう進みますか?

1. GET /api/v1/prices?country=bf&service=whatsapp で、対象の組み合わせの価格を取得します(サービスIDは自分のものに置き換えてください)。
2. POST /api/v1/activations に、ボディ {"service": "whatsapp", "country": "bf"} を送ってアクティベーションを作成します。返されたアクティベーションIDを保存してください。以降の処理はすべてこのIDを軸に進みます。
3. レスポンスに含まれる+226番号を使い、テスト対象のアプリからSMSの送信を発生させます。
4. Webhookで activation.sms_received を待ちます。X-OTPRoute-Signature ヘッダー(形式は t=<unix>,v1=<hex>)を確認し、エンドポイントのシークレットで "<t>.<raw body>" のHMAC-SHA256を計算して比較します。タイムスタンプが古いリクエストは破棄してください。細かいケースはHMACによるOTP Webhookの保護で解説しています。
5. Webhookを使わない場合は、数秒おきに GET /api/v1/activations/{id} をポーリングします。
6. 早めに終了したい場合や失敗パスを試したい場合は、POST /api/v1/activations/{id}/cancel を呼びます。コードが届かないまま終了したときは、activation.expired または activation.cancelled も届きます。

アカウントの上限は毎分300リクエストです。実行ごとに少し間隔を空けてバックオフすれば、ポーリングには十分な枠です。

コードを書かない担当者でも+226のコードを注文できますか?

はい。サポート担当、マーケター、アカウントマネージャーも手作業で同じことができます。サインインしてOTP Gatewayを開き、ブルキナファソを選び、サービスを指定して、画面に表示された価格を確認して注文してください。番号はすぐに表示されるので、アプリに貼り付けてSMSを要求すると、同じダッシュボードの行にコードが表示されます。タブを開いたままにしても、後で戻ってきても構いません。アクティベーションは20分間フルに待ち受けを続けます。

+226番号はどう保存すべきですか?SMSの言語は?

ブルキナファソの国内番号は8桁で、トランクプレフィックスはありません。そのため、取り除くべき先頭のゼロはなく、国内表記と +226 の後ろの数字は同じです。番号はE.164形式で、+226 に続けてその8桁を並べた形で保存してください。保存前には、ユーザー入力から空白、ハイフン、国際電話の 00 を取り除いて正規化します。トランクゼロのある国向けの検証ルールをそのまま流用すると、有効な+226の入力を弾いてしまいます。これはローカライズでよくあるバグなので、回帰テストを用意しておく価値があります。

行政、教育、ビジネスではフランス語が長く使われており、モシ語、ジュラ語、フルフルデ語も広く話されています。認証メッセージの多くは、アカウントのロケールに応じてフランス語か英語で届きます。数字の前後にアクセント付き文字があっても、パーサーが問題なく処理できるようにしておきましょう。

この国でのテストは、フランス語圏西アフリカへの展開、サインアップ画面のフランス語コピーの確認、決済やモバイルマネー系プロダクトの顧客オンボーディングなどで行われるのが一般的です。このパターンについてはフィンテックのオンボーディングのページで紹介しています。

番号にコードが届かないときは、何を試せばよいですか?

• ウィンドウが終わるまで待つ。 送信が遅れるサービスもあります。3分目でキャンセルすると、まだ成功したかもしれない実行を無駄にしてしまいます。
• そのサービスが仮想番号を受け付けるか確認する。 仮想番号を完全に拒否するプラットフォームもあります。だからこそ、未使用のアクティベーションは返金されます。
• 別のルートを試すか、時間をおいて再試行する。 時間帯を変えたり、近隣の西アフリカのルートを使ったりすると、挙動が変わることがよくあります。
• 短い間隔で繰り返し再注文しない。 連続した再注文は、送信側アプリのレート制限に引っかかりやすく、次の試行をかえって悪化させます。

再試行の設計については、OTP配信失敗を減らす方法のガイドでさらに詳しく解説しています。

ブルキナファソの長期利用番号はありますか?課金の仕組みは?

セルフサービスで利用できる長期利用の+226回線はありません。Dedicated Numbersは米国とカナダ向けのプロダクトで、月額$1.95/monthからご利用いただけ、SMSの送受信とブラウザからの通話に対応しています。ブルキナファソの恒常的な回線が必要な場合は、[email protected] までメールでご相談ください。手配できるかどうかは現地の規制次第で、お約束はできません。

+226のアクティベーション料金は、サブスクリプションやプラン選択のない、前払い制のUSDウォレット1つから差し引かれます。カードまたはUSDT/USDCでのチャージには、そのつどPDFの請求書がメールで届きます。連携開発では、開発用アカウントをサンドボックスに切り替えるよう依頼できます。サンドボックスではシミュレートされた番号とコードが返るため、テストスイートが実際の資金に触れることはありません。最新の料金は料金ページをご確認ください。

よくある質問

現地のSIMなしで、アプリのブルキナファソ向けサインアップフローをテストできますか?

はい。OTP Gatewayで+226番号を注文し、アプリからSMSを発生させて、ダッシュボードまたはAPIでコードを読み取ります。課金されるのはコードが届いた場合のみです。

OTP RouteのAPIで、ブルキナファソの国IDは何ですか?

bf です。価格やアクティベーションのエンドポイントを呼ぶときは、GET /api/v1/services で取得したサービスIDと組み合わせて使います。

+226の番号は0から始まりますか?

いいえ。ブルキナファソにはトランクプレフィックスがないため、番号はE.164形式で +226 に8桁を続けたものになります。

ブルキナファソの認証番号は、どのくらいの間有効ですか?

1回のアクティベーションにつき20分です。SMSが届かないままウィンドウが閉じた場合や、キャンセルした場合は、全額が自動的にウォレットへ戻ります。

コードはフランス語で届きますか?

送信元のサービスと、アカウントに設定された言語によります。フランス語か英語が一般的なので、プロダクトが両方に対応しているなら両方をテストしてください。

+226番号を使って、1つのプラットフォームで多数のアカウントを開設できますか?

いいえ。OTP Routeは、自社プロダクトのテストと、正当な業務用アカウントの運用のためのものです。大量のサインアップや架空のIDの使用は、利用規定とプラットフォーム自身の規約に違反します。

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