ベナン(+229)の認証コードに合うルートを選ぶ

必要なのはワンタイムコード?それとも保持する番号?

どの製品を使うかが決まるので、まずここをはっきりさせてください。

• 1回の認証ステップ(登録テスト、ログイン確認、ローカライズの確認):OTP Gatewayが適しています。各アクティベーションで、ちょうど1回分のコードのための+229番号が得られ、それで完了です。
• 来月もコードを受信する必要があるアカウント:ワンタイム番号ではその役割を果たせません。OTP Routeが長期の専用番号(Dedicated Numbers)を販売するのは米国とカナダのみで、月額$1.95からです。

現時点で、ベナン向けのセルフサービスの長期回線はありません。チームに運用上の本当の必要がある場合は、[email protected] に用途を添えてお知らせください。何か手配できるかどうかは現地の規制によるため、確約はありません。西アフリカのチーム向けに両方の選択肢を比較したメモは、一時番号と専用番号の違いにあります。

現在、ベナンの番号にコードを送るアプリは?

ベナンのルートは、合計1,500を超えるサービスを掲載しています。リアルタイムのスナップショットで人気のものには、WhatsApp、Facebook、imo、Telegram、Instagram、TikTok、Google (Gmail & YouTube)、Microsoft & Outlook、ChatGPT (OpenAI)、Claude、LinkedIn、Discord、Viber、Uber、Amazonがあります。

この一覧は保証ではなくスナップショットです。サービスごとの在庫は日中に変動するため、自動化では空き状況をハードコードせず、実行時にAPIから読み取ってください。

+229のアクティベーションに使うAPI呼び出しは?

すべては https://otproute.com/api/v1 に対し、Developerコンソールで発行したBearerキーで行います(キーは or_live_ で始まり、1アカウントに最大10個持て、毎分300リクエストまで可能です)。

1. GET /api/v1/services と GET /api/v1/countries を取得して、両方をキャッシュします。ベナンの国IDは bj です。
2. GET /api/v1/prices?country=bj&service=<id> で、コードが今いくらかかるかを問い合わせます。
3. POST /api/v1/activations に、ボディ {"service": "<id>", "country": "bj"} を送って注文を作成します。返されたアクティベーションIDを保存します。
4. 番号をテスト対象のフローに入力し、Webhookで activation.sms_received を待つか、GET /api/v1/activations/{id} をポーリングします。
5. テストが中止された場合は、POST /api/v1/activations/{id}/cancel を呼び出し、保留分をウォレットへ戻します。

Webhookの配信は X-OTPRoute-Signature で署名されています。信頼する前に、タイムスタンプと生の本文に対するHMAC-SHA256を再計算してください。リクエストの全形式はAPIドキュメントにあります。

コードを書かない人もベナンの番号を注文できる?

はい。サインインしてOTP Gatewayを開き、ベナンとサービスを選び、確定する前に画面の価格を確認します。+229番号はすぐに表示されるので、確認するアプリに入力し、タブを開いたままにしてください。コードは届いたとき、注文の隣に表示されます。サポートや運用のスタッフは、エンジニアがスクリプトで同じ作業を行う一方で、単発の確認にこの方法をよく使います。

+229番号はどう保存し、正規化すべき?

ベナンは2024年に国内番号を8桁から10桁に移行したため、CRMやテスト用フィクスチャの古い記録には、まだ短い形式が残っている場合があります。すべてE.164で保存してください。+229 に国内番号全体を続け、スペースは入れません。

一般的なバリデーターを悩ませる点がひとつあります。新しい形式では、先頭の0はトランクプレフィックスとして働くのではなく、加入者番号そのものの一部です。国番号の後ろの先頭の 0 を無条件に取り除く正規化処理は、ベナンの番号を壊してしまうため、この国には専用のルールとテストケースを用意してください。

公用語はフランス語で、フォン語、ヨルバ語などの言語も広く話されています。認証テキストの多くは、アカウントの言語設定に応じてフランス語または英語で届くため、パーサーがキーワードを探している場合は確認する価値があります。このルートをテストするのは、フランス語圏の西アフリカに展開するときで、トーゴやナイジェリアとあわせて行うことが多くなっています。

ベナンのコードが届かない場合は?

配信のタイミングはサービスとルートによって異なるため、反応する前にアクティベーションに余裕を持たせてください。SMSが届かないまま20分の有効時間が終了すると、注文は期限切れとなり、全額が自動的にウォレットへ戻ります。

• 後で再試行するか、同じサービスを別のルートで試します。
• サービスが仮想番号をそもそも受け付けるか確認します。拒否するサービスもあり、まさにそのために返金があります。
• 短い間隔のループで再注文しないでください。試行の間にバックオフを入れ、各試行のアクティベーションIDをログに残します。

各サービスの利用規約を守り、OTP Routeの利用規定(Acceptable Use Policy)がすべての注文に適用されることを忘れないでください。こうしたリトライをテストスイートに組み込む方法は、QAテストガイドで紹介しています。

ベナンのテスト費用はどう支払う?

前払い式のUSDウォレットが1つあり、月額料金も、選ぶプランもありません。カードまたはUSDT/USDCのステーブルコインでチャージでき、ベナンのチャージごとにPDFの請求書が受信トレイに届きます。連携の作業では、リクエストにより開発アカウントをサンドボックスに切り替えられ、シミュレートされた番号とコードが返るので、ウォレット資金を使わずにパイプラインをエンドツーエンドで試せます。

よくある質問

現地SIMなしで、ベナンの登録フローをテストできますか?

はい。OTP Gatewayで+229番号を注文し、アプリに入力して、ダッシュボードまたはAPIでコードを読み取ってください。各番号は1回の認証に対応します。

OTP Route APIでベナンに使う国IDは何ですか?

ベナンは bj です。価格の確認やアクティベーションの作成の際に、country の値として渡します。

テスト用の+229番号はいくらですか?

料金は$0.20/コードからで、サービスによって異なります。正確な金額は GET /api/v1/prices が返し、注文前にダッシュボードでも表示されます。

保持するアカウント向けに、ベナンの月額番号はありますか?

ベナンにはセルフサービスの選択肢はありません。専用番号(Dedicated Numbers)は米国とカナダ向けの製品です。具体的な運用上の必要がある場合は、[email protected] にメールしてください。

バリデーターは、ベナンの番号の先頭のゼロを取り除くべきですか?

いいえ。10桁への移行以降、そのゼロは番号の一部なので、E.164で保存するときは +229 の後ろに残してください。

SMSが届かなかった場合、お金を失いますか?

いいえ。20分以内に何も届かない場合、またはキャンセルした場合は、全額が自動的にウォレットへ戻ります。

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