QA・フィンテック・ローンチチーム向けナイジェリア(+234)SMS認証API

ナイジェリアのOTPを受信するには、どのエンドポイントを呼び出せばよいですか?

すべてのエンドポイントは https://otproute.com/api/v1 配下にあり、or_live_ で始まるBearerキーで認証します。ナイジェリアの国IDは ng です。一般的な連携では次の4つの呼び出しを行います。

1. GET /api/v1/prices?country=ng&service=<id> で、確保する前に現在の価格を確認します。
2. POST /api/v1/activations に {"service": "<id>", "country": "ng"} を渡して、+234の番号を確保します。返されるアクティベーションIDは保管してください。以降の呼び出しやWebhookイベントはすべてこのIDで紐づきます。
3. GET /api/v1/activations/{id} でステータスを確認し、配信済みであればコードを読み取ります。
4. テストが途中で失敗して番号が不要になった場合は、POST /api/v1/activations/{id}/cancel を呼びます。

GET /api/v1/balance はCIの事前チェックに便利で、ウォレット残高が少ないときに夜間スイートを早めに失敗させられます。同じ手順をエラー処理も含めて解説したのがOTP API連携ガイドです。

ラゴスのテストスイートはポーリングとWebhookのどちらを使うべきですか?

手動で数回実行する程度ならポーリングで十分です。パイプラインが+234の番号を複数同時に注文するようになったら、Webhookのほうがすっきりします。5つまで登録できるエンドポイントのうち1つを開発者コンソールに登録し、activation.sms_received、activation.expired、activation.cancelled を購読してください。

各リクエストには X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。エンドポイントのシークレットを使って、タイムスタンプ、ドット、生のボディを連結したものに対するHMAC-SHA256を再計算し、定数時間で比較し、タイムスタンプが古いリクエストは破棄します。処理済みのアクティベーションIDを保存しておけば、再配信されたイベントでテストが二重に動くことはありません。より詳しいチェックリストはHMACによるOTP Webhookの保護の記事にあります。アカウントあたりのトラフィックは毎分300リクエスト未満に収めてください。ポーリングを細かく繰り返さずイベントに任せれば、十分な余裕があります。

+234のルートではどのサービスが利用できますか?

ng ルートには現在2,700を超えるサービスが並んでいます。よくリクエストされるものとして、WhatsApp、Telegram、Google(Gmail & YouTube)、TikTok、Facebook、Instagram、X(Twitter)、Snapchat、LinkedIn、Uber、Discord、Microsoft & Outlook、Amazon、ChatGPT(OpenAI)などがあります。在庫はキャリアパートナーの供給状況に応じて一日の中で変動するため、昨日見えていたサービスが今日もあると決めつけず、リアルタイムの空き状況を確認してください。

そもそもなぜナイジェリアの認証用番号が必要になるのですか?

ナイジェリアはアフリカでも有数のフィンテック・コンシューマーアプリ市場で、多くのプロダクトが電話番号を主要な本人識別情報として扱っています。そのためSMSのステップは、ウォレット、融資アプリ、配車、デリバリー、ソーシャル系プロダクトのオンボーディングで重要な役割を果たします。国外のチームは、サインアップフロー、再送タイマー、エラー文言が現地ユーザーと同じように動作するかを確認するため、テスト用の+234番号を利用します。

公用語は英語なので、認証メッセージは通常英語で届き、自動テストのアサーションロジックをシンプルに保てます。特にフィンテックのチームは、OTP Routeが代替しない本人確認との併用方法について、フィンテックのオンボーディングのページをご覧ください。

ナイジェリアの携帯番号はどのような形式ですか?

国番号は+234で、国内プレフィックスは 0 です。ナイジェリアでは携帯番号を0から始まる11桁、たとえば0803 123 4567のように書くのが一般的です。国際形式では先頭の0が取れて、+234 803 123 4567となります。E.164形式(+234803...)で保存し、入力時には国内の11桁形式も受け付け、保存前に先頭の 0 を取り除いてください。全体の桁数しか検査しないバリデータは +2340803... を通してしまい、これが本番環境で送信に失敗する頻度の高い原因になっています。

代わりにダッシュボードからナイジェリアの番号を注文できますか?

はい。メール認証コードまたはGoogleでサインアップし、ウォレットにチャージして、OTP Gatewayを開き、ナイジェリアとサービスを選んで、表示された価格を確認します。番号はすぐに使えるようになり、コードが届くと注文の横に表示されます。

届かない場合は、20分のウィンドウが終わるまで待ってください。課金されるのはコードが届いた場合のみで、期限切れやキャンセルになった注文は自動的に返金されます。そのうえで、少し時間をおいて新しく注文し直すか、テストの内容が許せばガーナのような別のルートを試し、サービス側が仮想番号を拒否していないかも確認してください。新規注文を短い間隔で連続して出すのは避けましょう。

ナイジェリアの長期回線、課金、サンドボックスについて教えてください

OTP Routeには、セルフサービスで利用できるナイジェリアの長期番号はありません。専用番号(Dedicated Numbers)はアメリカとカナダのみで、月額$1.95から提供しています。+234の長期回線が必要な場合は[email protected]までメールしてください。提供できるかどうかは現地の規制によります。

利用料金は、プランも月額料金もない前払いのUSDウォレット一本から支払われます。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書が発行されます。開発用アカウントをサンドボックスモードに切り替えるようサポートに依頼すれば、連携がシミュレーションされた番号とコードを受け取れるため、ウォレット残高を使わずにWebhookまでの全経路をテストできます。

よくある質問

現地のSIMがなくても、アプリのナイジェリア向けサインアップフローをテストできますか?

はい。OTP Gatewayで+234の番号を注文し、ダッシュボードまたはAPIでコードを読み取ってください。

OTP Route APIでのナイジェリアの国IDは何ですか?

価格照会とアクティベーションのリクエストでは、国の値として ng を使います。

ナイジェリアのSMS OTPを受信するにはいくらかかりますか?

1コード$0.20〜で、正確な金額はサービスによって異なり、価格エンドポイントから取得できます。

SMSが届かなかった場合も料金は発生しますか?

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

0803 123 4567のような番号はどのように保存すればよいですか?

先頭のゼロを取り除き、スペースなしのE.164形式である +2348031234567 で保存してください。

これらの番号はどのアカウントにでも使ってよいのですか?

ご自身の正当なプロダクトとアカウントに限ります。各サービスの利用規約とOTP Routeの利用規定(Acceptable Use Policy)に従ってください。仮想番号を完全に拒否するサービスもあります。

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