QA、ローンチ、運用チームのための、ルワンダ(+250)の認証コード

ルワンダの認証用番号が必要なのは誰ですか?

キガリは、地域のスタートアップ、フィンテックの実証、東アフリカの運用チームの拠点になっており、そこで展開するプロダクトは、電話番号の認証手順を、実際のルワンダのルートでテストする必要があります。典型的な例は、ルワンダ向けにローカライズされる決済やオンボーディングのフロー(フィンテックのオンボーディングを参照)、地域オフィスのビジネスアカウントを運用するサポートチーム、そしてケニアやウガンダと並んで+250の経路をCIでカバーしたいQAエンジニアです。

E.164形式では、+250の番号はどう表記しますか?

ルワンダの国番号は+250で、国内プレフィックスは 0 です。携帯電話の番号は、国内では07X XXX XXXXと表記されるため、保存する形は +2507XXXXXXXX になります。先頭の 0 を取り除き、続く9桁を残します。フォームが、国内の 07... の形に加えて +250 や 00250 も受け付けること、そして +2500... を決して保存しないことを確認してください。

キニャルワンダ語、英語、フランス語、スワヒリ語はいずれも公用語です。国際的なサービスの多くは認証テキストを英語で送りますが、アカウントの言語に合わせるものもあるため、メッセージを表示する画面が、提供するロケールに対応しているか確認してください。

最初の+250の注文の前に、何を準備しておくべきですか?

短い準備をしておけば、後で無駄な注文をせずに済みます。

• TOTPの二要素認証を有効にし、少額の残高を入れたOTP Routeアカウント
• 環境ごとに1つのBearerキー。CIとノートPCで認証情報を共有しないため
• 国ID rw とサービスIDを、ハードコードせず設定に保存しておくこと
• シークレットをシークレット管理ツールに保管したWebhookエンドポイント、または適切な間隔のポーリング用ヘルパー
• 自社プロダクトに、電話番号を変更できるテスト用アカウント

各スイートの開始時に GET /api/v1/balance で残高を確認しておけば、実行を途中ではなく最初の段階で失敗させられます。

ルワンダのSMS OTPコードを受信できるサービスは?

現在、rw では900を超えるサービスが一覧に載っています。最新のスナップショットでよく使われるルートには、WhatsApp、Telegram、Facebook、Instagram、X (Twitter)、TikTok、Google(Gmail & YouTube)、LinkedIn、imo、Uber、ChatGPT (OpenAI)、Claudeがあります。OTPルーティングの在庫は1日の中で変わるため、注文する直前にAPIで利用可否を確認してください。

ルワンダOTP APIの流れはどうなっていますか?

Developerコンソールで取得した or_live_ のBearerキーで、https://otproute.com/api/v1 に認証します。

1. GET /api/v1/prices?country=rw&service=whatsapp が、現在の価格と、そのルートが注文を受けられるかを返します。
2. POST /api/v1/activations に {"service": "whatsapp", "country": "rw"} を送ると、アクティベーションIDと+250番号が返ります。
3. 番号を自社のアプリに入力し、コードを要求します。
4. activation.sms_received のWebhook、または GET /api/v1/activations/{id} のポーリングで受け取ります。
5. テストが途中で止まった場合は、POST /api/v1/activations/{id}/cancel で中止します。

X-OTPRoute-Signature(エンドポイントのシークレットによる <t>.<raw body> のHMAC-SHA256)を検証し、古いタイムスタンプは拒否し、各アクティベーションIDは1回だけ処理してください。全体像はWebhookによるコード取得ガイドとAPIドキュメントにあります。

開発者以外が、テスト用の+250番号を注文するには?

ダッシュボードでOTP Gatewayを開き、ルワンダとサービスを選び、価格を確認して確定したら、番号をテスト対象のアプリに貼り付けます。コードは注文カードに表示されます。20分たってもSMSが届かなければ、注文は終了し、代金はウォレットに戻ります。

コードがまったく届かない場合は?

+250の注文で何も届かないときは、たいてい、ありふれた理由があります。

• プラットフォームが番号を拒否した。 仮想番号を拒否するサービスもあり、だからこそ未使用の注文は返金されます。テストの内容が許すなら、別のサービスルートや、ウガンダのような近隣の市場を試してください。
• フォームが番号を壊した。 アプリが +250 と9桁を、余分な 0 なしで送信したか確認します。
• ルートが一時的に混み合っていた。 1分でキャンセルせず、有効時間が終わるまで待ってから、後で再試行します。

短い間隔で再注文するのは避け、試行の間に間隔をあけて、自分のスクリプトが対象プラットフォームから悪用のように見えないようにしてください。

長期回線と課金については?

OTP Routeには、ルワンダのセルフサービスの長期番号はありません。運用上の必要があるチームは、[email protected] にメールできますが、提供の可否は現地の規則によるため、確約はできません。Dedicated Virtual Numbersは、月額$1.95からで、米国とカナダのみが対象です。

お支払いは、1つのUSDウォレットによる従量課金で、カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届き、月額料金はありません。連携作業のために、シミュレートされた番号を使うサンドボックスのアクセスも、リクエストに応じて利用できます。各サービスの利用規約と、OTP Routeの利用規定(Acceptable Use Policy)に従ってください。

よくある質問

現地のSIMカードなしで、アプリのルワンダ向けサインアップフローをテストできますか?

はい。OTP Gatewayで、自社サービス向けの+250番号を注文し、コードはダッシュボードまたはAPIで読み取れます。

APIでのルワンダの国IDは何ですか?

rw です。GET /api/v1/prices と、POST /api/v1/activations のボディで使います。

保存するルワンダの携帯電話番号は、先頭の0を残すべきですか?

いいえ。国内プレフィックスの 0 を取り除いて+250を付けるので、078X XXX XXXは+25078XXXXXXXになります。

ルワンダのアクティベーションは、どのくらいの間開いていますか?

20分です。その間にSMSが届かなかった場合や、キャンセルした場合は、請求額の全額がウォレットに戻ります。

+250のコードの受信に、ポーリングではなくWebhookを使えますか?

はい。最大5つのエンドポイントを登録し、activation.sms_received、activation.expired、activation.cancelled を待ち受け、配信のたびに署名ヘッダーを検証します。

ルワンダの番号を、長期的に保持する方法はありますか?

セルフサービスの方法はありません。長期のDedicated Numbersは、米国とカナダのみで販売しています。ルワンダについては [email protected] に問い合わせることができますが、何も約束されるものではありません。

ルワンダの認証コードの支払いはどうすればよいですか?

プリペイドのUSDウォレットに、カードまたはUSDT/USDCでチャージし、届いたコードごとに支払います。現在の開始料金は料金をご覧ください。

お金をかける前に、連携を試せますか?

はい。開発アカウントのサンドボックスモードを依頼すれば、シミュレートされた番号とコードが得られます。本番で使うときにサインアップしてください。

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