+211のSIMなしで南スーダンのサインアップフローをテストする

課題:南スーダンへの展開なのに、チームに現地のSIMがない

すでに東アフリカでサービスを提供しているプロダクトが、国の選択肢に南スーダンを追加する場面を想像してください。QAは、+211番号がバリデーションを通り、コードを受信し、ユーザーを正しい画面に導くことを確認する必要があります。チームの誰もジュバにはおらず、国際ローミングの手配には時間がかかり、同僚の個人の携帯をテストアカウントに借りるのは、やめるべき習慣です。

リモートの南スーダン認証番号は、この問題の狭い部分、つまり実際のコードを1つ、スクリプトやブラウザからオンデマンドで+211回線に届けることを解決します。より広いワークフローについては、QAテストのページで解説しています。

OTP Routeは+211番号に対して何を提供しますか?

OTP Gatewayは、1回の認証用に南スーダンの番号を割り当てます。サービスと国を選んでアプリで番号を使うと、コードがダッシュボードとお客様のシステムに配信されます。アクティベーションは20分間有効で、課金されるのはSMSが届いた場合のみです。

現在のスナップショットでは、南スーダンで900を超えるサービスが表示されており、WhatsApp、Facebook、imo、Telegram、Instagram、TikTok、Snapchat、Viber、Signal、Google(Gmail & YouTube)、X(Twitter)、Uberなどが含まれます。在庫は一日の中で変動するため、これは目安として扱い、実行前にライブのリストを照会してください。

南スーダンのOTP APIは、コードではどう動きますか?

クライアントをhttps://otproute.com/api/v1に向け、Developerコンソールで発行したBearerキー(or_live_…)を使います。国IDはssです。

• GET /api/v1/prices?country=ss&service=<id>は、その組み合わせの本日の価格を返します。
• POST /api/v1/activations に {"service": "imo", "country": "ss"} を送ると、番号が確保されます。
• GET /api/v1/activations/{id}でコードをポーリングできます。POST /api/v1/activations/{id}/cancelで早めに解放できます。

並列スイートでは、ポーリングよりWebhookの方が適しています。activation.sms_receivedとactivation.expiredを購読し、X-OTPRoute-Signature(エンドポイントのシークレットによる<t>.<raw body>のHMAC-SHA256)を検証し、古いタイムスタンプは破棄し、ハンドラーはアクティベーションIDに対して冪等にしてください。特にパイプラインでは、CIパイプラインでのSMS OTPテストで説明しているメリットがあります。各アカウントはキー10個とWebhookエンドポイント5個を保持でき、スループットの上限は1分あたり300リクエストです。

開発者がいない場合は、ダッシュボードを使いましょう

1. サインインして、OTP Gatewayを開きます。
2. 南スーダンを選び、続いてテストするサービスを選びます。
3. 表示された価格を確認して確定し、+211番号をコピーします。
4. アプリに入力し、同じページでコードの到着を待ちます。
5. テストが中止になった場合はキャンセルします。金額はウォレットに戻ります。

番号の形式、言語、現地の事情

南スーダンは、2011年の独立後に独自の国番号+211を取得したため、古い連絡先データや一部の旧式のバリデーションライブラリでは、いまだに挙動がおかしくなることがあります。携帯番号は国番号の後に9桁が続きます。国内ダイヤル用に書く場合は通常先頭に0が付きますが、E.164に変換する際にはこれを外し、+211に9桁を続けて保存します。

公用語は英語で、ジュバ・アラビア語も広く話されているため、アプリのロケールによって認証SMSは英語またはアラビア語で届くことがあります。両方のテンプレートと、アラビア語のコピーの右から左への表示もテストに加えるのが賢明です。チームは、人道支援や物流の業務、地域のビジネスアカウント、海外で+211番号を保持しているディアスポラのユーザーのためにも、ここでテストを行います。

コードが届かない場合は?

• 再試行する前に、20分のウィンドウが終わるまで待ちます。
• そのサービスが仮想番号を受け付けているか確認します。拒否するサービスもあります。
• 短時間に連続で注文するのではなく、時間をおいて再試行するか、別のサービスルートに切り替えます。
• Webhookエンドポイントが、有効な署名を拒否していないか確認します。

期限切れまたはキャンセルされたアクティベーションは自動的に返金されるため、請求する必要はありません。そのほかの対処は、OTP配信失敗を減らすにはをご覧ください。

長期回線、ウォレット、サンドボックス

OTP Routeには、セルフサービスの南スーダン長期番号はありません。月額$1.95からのDedicated Numberは、米国とカナダのみで利用できます。継続的に使える+211回線が必要な場合は、[email protected]までご連絡ください。実現できるかどうかは現地の規則次第です。

支払いは月額料金のないプリペイドUSDウォレットで行います。カードまたはUSDT/USDCでチャージし、チャージごとにPDFの請求書を受け取り、最新の料金は料金ページで確認できます。開発用には、リクエストに応じてサンドボックスモードを有効にでき、シミュレートされた番号とコードが返されるため、実際の支出の前に連携を検証できます。

よくある質問

国内にいなくても、南スーダンのSMS OTPを受信できますか?

はい。OTP Gatewayはリモートで+211番号を提供し、コードはダッシュボードとAPIに表示されます。

南スーダンのAPI国IDは何ですか?

アクティベーションの作成や価格の照会にはssを使います。

+211番号は先頭のゼロ付きで保存すべきですか?

いいえ。現地の0を取り除き、E.164形式、つまり+211に9桁を続けた形で保存してください。

南スーダンの番号で動作するサービスはいくつありますか?

現在のライブリストには900を超えるサービスがありますが、可用性は一日の中で変わります。

CIパイプラインから、アプリの南スーダン向けサインアップフローをテストできますか?

はい。ジョブから国ssでアクティベーションを作成し、署名付きWebhookでactivation.sms_receivedを受信し、同じテストステップでコードを送信します。サンドボックスアカウントなら、ウォレットの資金を使わずにこれを試せます。

アクティベーションをキャンセルするとどうなりますか?

20分のウィンドウがコードなしで終了した場合と同様に、全額が自動的にウォレットに戻ります。

テスト用の+211番号は、どんな用途にも使えますか?

いいえ。ご自身の正当なプロダクトのテストや運用に使い、各サービスの利用規約を守り、OTP Routeの利用規定(Acceptable Use Policy)の範囲内でお使いください。

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