リベリア（+231）の認証コードをテスト実行に取り込む

そもそもなぜリベリアの番号が必要なのか？

リベリアは英語圏の西アフリカ市場で、沿岸部に沿って展開する企業にとって最初の拠点にしやすい国です。文言をほとんど翻訳しなくて済むため、テストの労力を認証フローそのものに振り向けられます。リベリアにルーツを持つ人々を顧客に抱えるチームも、故郷にいる親族がサインアップを最後まで完了できるかを確かめるために+231に注目します。とくにフィンテックやマーケットプレイスの製品では、ローンチ前に現地の番号が自社のチェックを通過することを確認する必要があります。より広い進め方についてはフィンテックのオンボーディングをご覧ください。

3つ目のグループが、リベリアの拠点やパートナー向けに業務用アカウントを管理する運用担当者です。1回限りの認証にGatewayの番号を使えば、社員の個人電話を会社のプロフィールに結び付けずに済み、コードはチーム全員が見られる場所に届きます。

+231のルートでは何を認証できるのか？

この国では現在、1,700を超えるサービスが掲載されています。よく選ばれるものには、WhatsApp、Facebook、TikTok、Telegram、Instagram、Google（Gmail＆YouTube）、Snapchat、imo、Viber、X（Twitter）、LinkedIn、Microsoft＆Outlookがあります。利用できる状況は一日の中で変動するため、APIは固定のカタログではなく、最新の可用性を返します。

テスト計画では、ユーザーが実際に頼っているサービスを2、3個挙げ、実行の最初に価格の照会でそれぞれの組み合わせを確認してください。今朝は+231で動いたメッセージングアプリが、午後には一時的に使えなくなることもあります。先に確認するパイプラインなら、タイムアウトではなく、はっきりした理由で失敗します。

リベリアの連携ではどのエンドポイントを呼ぶのか？

すべてhttps://otproute.com/api/v1の配下にあり、開発者コンソールのBearerキーを使います。

• GET /api/v1/servicesとGET /api/v1/countriesでIDを調べます。リベリアはlrです。
• GET /api/v1/prices?country=lr&service=<id>で、その組み合わせの価格を確認します。
• POST /api/v1/activationsに{"service": "<id>", "country": "lr"}というボディを渡して注文を作成します。
• Webhookでactivation.sms_received、activation.expired、activation.cancelledをアクティベーションIDをキーに受け取るか、GET /api/v1/activations/{id}をポーリングします。

WebhookごとにX-OTPRoute-Signatureを検証してください。エンドポイントのシークレットで<t>.<raw body>のHMAC-SHA256を計算し、古いタイムスタンプは拒否します。詳細はWebhookのセキュリティに関する記事にあります。

コードを書かずにリベリアのSMS OTPを受信できるか？

はい。ダッシュボードでリベリアとサービスを選び、表示された価格を確認して注文します。+231番号をアプリに貼り付けると、配信され次第、注文の横にコードが表示されます。そのままアプリのコード入力欄にコピーしてください。不要になった注文は、同じ画面からキャンセルすれば、残高がすぐに戻ります。

+231番号はどう整形して正規化すればよいか？

リベリアの番号は、国内ではふつう先頭にトランクプレフィックスの0を付けて書かれます。この0を外して+231を付ければ、データベースに保持すべきE.164形式になります。国内の通信事業者が異なっても、携帯番号の国番号はすべて同じ+231なので、OTPをルーティングする際に事業者で処理を分ける必要はありません。検証は国内形式ではなく国際形式に対して行い、サポートチームが見慣れた国内表記を好むなら、表示用の文字列を別に持ってください。公用語は英語なので、サービスのテンプレートの多くは英語で届きます。コードの抽出は簡単になりますが、サービスは予告なく文面を変えるため、固定の文ではなく数字の並びに合わせて抽出するようにしてください。

リベリアのコードが遅れたり届かなかったりするときは？

配信はサービスとルートによって左右されます。何も表示されない場合は次のとおりです。

• 20分のウィンドウが終わるまで待ちます。キャンセルや期限切れの注文は全額が返金されます。
• 時間をおいて、または別のサービスルートでやり直します。
• そのサービスが仮想番号を受け付けるか確認します。拒否するものもあります。
• 続けざまに再注文するのは避けてください。試行回数を消費するだけです。

詳しくはOTP配信の失敗を減らすをご覧ください。

リベリアの長期回線はあるのか、支払いはどうなるのか？

リベリアには、セルフサービスで利用できる長期番号はありません。専用回線は米国とカナダ向けの製品で、$1.95/月からです。リベリアの回線を長く使いたい場合は、[email protected]までメールをお送りください。可能かどうかは現地の規則次第で、保証はできません。リベリアのテスト計画の多くは、サインアップや確認の各ステップに必要なコードが1つだけなので、Gatewayで足ります。

課金は、月額料金なしのプリペイドUSDウォレット1つで行います。カードまたはUSDT/USDCでチャージし、PDFの請求書をメールで受け取り、開発中はサンドボックスモードをリクエストできます。始めるにはサインアップへどうぞ。

よくある質問

海外から、アプリのリベリア向けサインアップフローをテストできるか？

はい。OTP Gatewayで+231番号を注文し、遠隔で認証を完了できます。現地のSIMは必要ありません。

APIはリベリアにどの国IDを使うか？

POST /api/v1/activationsのcountryフィールドと、価格の照会にlrを使います。

リベリアのコードはいくらか？

リベリアの注文は$0.20/コードからで、金額はサービスによって異なります。正確な金額はGET /api/v1/pricesで返され、注文前に表示されます。

リベリアのコードが届かなかった場合、残高はどうなるか？

料金はかかりません。+231の注文で20分以内にSMSが届かなかった場合、またはキャンセルした場合は、全額が自動的にウォレットへ返金されます。

来週も同じ+231番号を再利用できるか？

いいえ。Gatewayの番号は、認証コード1回分のためのものです。長期回線があるのは米国とカナダだけです。

ポーリングとWebhookのどちらを使うべきか？

Webhookの方がシステムへの負荷は軽く、スクリプトならポーリングで十分です。Webhookを使い、ハンドラーが止まっているときにポーリングへ切り替えるチームも多くあります。

ウォレットに課金されないテストモードはあるか？

はい。リクエストに応じて、開発用アカウントをサンドボックスに切り替えられ、模擬の番号とコードが返されます。

認証してよい対象に制限はあるか？

あります。対象アプリ自身の規約と、OTP RouteのAcceptable Use Policyが適用されます。リベリアの番号は、自社製品のテストと、組織が正当に所有するアカウントの運用のためのものです。

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