ジンバブエのユーザー向け+263認証番号を扱うには

+263番号はどのように正規化すればよいですか?

ジンバブエは、トランクプレフィックスの典型的な例です。国内では携帯電話番号を先頭の0付きで 07X XXX XXXX のように書きますが、国際形式ではこのゼロが消えて+263 7X XXX XXXXとなり、国コードの後ろは9桁です。ユーザーは両方の書き方を混在させ、中には +263 07... と入力する人もいますが、これはどのネットワークでもルーティングされません。

入力時に次のように正規化します。

• 番号が 0 で始まり、国がジンバブエの場合は、ゼロを取り除いて +263 を付けます。
• +2630 で始まる場合は、国コードの直後のゼロを削除します。
• 00263 は +263 に変換します。
• 保存するのはE.164形式の結果だけにして、表示用の整形は後で行います。

テスト用の+263番号が検証すべきなのはまさにこのロジックです。正規化処理に不具合があっても単体テストでは問題なく見えて、実際の番号でだけ失敗するからです。

ジンバブエのOTPテストには、どのような言語やユーザーの傾向が関係しますか?

ジンバブエには多くの公用語があり、英語、ショナ語、ンデベレ語が最も広く使われています。グローバルアプリの認証メッセージは英語で届くことが多く、コードの抽出は簡単ですが、自社のテンプレートではショナ語やンデベレ語の文面が必要になる場合があり、1セグメントに収まる短さを保つ必要があります。

ユーザー層は国境の外にも広がっています。南アフリカと英国には大きなディアスポラがおり、決済、送金、メッセージングの各プロダクトでは、海外にいる送信者と国内の受信者の両方を認証しなければなりません。モバイルマネーは日常生活の一部なので、フィンテックのチームは、電話番号ベースのオンボーディングが実際の+263番号で正しく動作するかを確認したがります。南部アフリカ全体に展開する際には、ジンバブエを南アフリカやザンビアと並べてテストする地域向けプロダクトもあります。

ジンバブエの認証番号は、どのサービスからコードを受信できますか?

ジンバブエのルートには1,700を超えるサービスが掲載されています。最新のスナップショットでは、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、ChatGPT (OpenAI)、Claude、Microsoft & Outlook、LinkedIn、Amazon、Discord、Uber、Signalが目立ちます。

利用可否は一日の中で変わるため、昨日のルートがまだ使えると決めつけず、テストの前に zw を確認してください。

APIでジンバブエのSMS OTPを受信するには?

Developerコンソールで or_live_ キーを発行し、Bearer認証で https://otproute.com/api/v1 を呼び出します。流れは次のとおりです。

1. GET /api/v1/prices?country=zw&service=linkedin が最新の価格を返し、その組み合わせが利用可能であることを示します。
2. {"service": "linkedin", "country": "zw"} を指定した POST /api/v1/activations が、番号とアクティベーションIDを返します。
3. テストが認証SMSを発生させます。
4. activation.sms_received Webhookがエンドポイントに届くか、GET /api/v1/activations/{id} をポーリングします。
5. 不要になったものは POST /api/v1/activations/{id}/cancel で終了します。

X-OTPRoute-Signature ヘッダーが検証できるまで、すべてのWebhookは信頼しないでください。エンドポイントのシークレットを使って、タイムスタンプ、ドット、生の本文に対するHMAC-SHA256を計算し、古いタイムスタンプは破棄します。再送でテストが二重に実行されないよう、アクティベーションIDをキーにしてハンドラーを冪等にしておきます。上限は毎分300リクエスト、APIキー10個、Webhookエンドポイント5個です。このジンバブエOTP APIの設定の詳細は、ドキュメントとHMACによるOTP Webhookの保護をご覧ください。

ダッシュボードだけで、1回限りの+263認証を行えますか?

はい、コードを書く必要はありません。OTP Gatewayを開き、ジンバブエとサービスを選んで、表示された価格を確認し、注文します。サービスが電話番号を求める画面でその番号を入力してコードを要求すると、受信後にアクティベーション上にコードが表示されます。運用担当者は、同僚の個人の電話番号を明かさずに会社のアカウントを認証したいときに、このルートをよく使います。

+263のコードが表示されない場合はどうすればよいですか?

アクティベーションの有効時間は20分です。この時間内にSMSが届かなかった場合、またはキャンセルした場合は、全額が自動的にウォレットへ返金されます。支払うのは、実際に届いたコードの分だけです。

メッセージが遅いときは、すぐに対応せず、まず有効時間が終わるまで待ってください。サービスによっては仮想番号を受け付けないものがあるため、先にそれを確認してください。後で再試行するか、別のサービスルートに切り替え、自動テストが短い間隔で繰り返し注文しないようにします。適切な再試行ポリシーは、CIパイプラインでのSMS OTPテストのガイドで紹介しています。

ジンバブエで長期利用できる回線はありますか?料金はどうなりますか?

ジンバブエには、セルフサービスで利用できる長期番号はありません。Dedicated Numbersは米国とカナダのみで、$1.95/月からご利用いただけます。継続して使える+263回線が必要な場合は、[email protected]までメールでご相談ください。提供できるかどうかは現地の規則によります。

OTP Routeの請求は、プリペイド式のUSDウォレット1つで行われます。従量課金で月額料金はなく、チャージはカードまたはUSDT/USDCに対応し、チャージのたびにPDFの請求書がメールで届きます。詳しくは料金をご覧ください。開発用アカウントは、ご依頼に応じてサンドボックスに切り替えられ、資金を使わずにOTPルーティングを試せるよう、模擬の番号とコードが返されます。実番号は、ご自身の正当なアカウントにのみ使用し、各サービスの利用規約を守り、OTP Routeの利用規定(Acceptable Use Policy)に従ってください。

よくある質問

ハラレのSIMがなくても、ジンバブエ向けのオンボーディングをテストできますか?

はい。OTP Gatewayの+263番号を使えば、フローを実行し、コードをダッシュボードまたはAPIで確認できます。

ジンバブエの番号は先頭のゼロ付きで保存すべきですか?

いいえ。トランクの0を取り除き、+263に続けて国内の9桁を保存してください。

OTP Route APIでのジンバブエの国IDは何ですか?

zw です。価格の照会とアクティベーションのリクエストで使います。

ジンバブエの認証番号は1コードあたりいくらですか?

サービスによって異なりますが、$0.20/コードからです。最新の金額はダッシュボードと GET /api/v1/prices で確認できます。

SMSが届かなかった場合、お金は失われますか?

いいえ。届かなかったコードとキャンセルしたアクティベーションは、20分の有効時間が過ぎるか、キャンセルした時点で、自動的にウォレットへ返金されます。

連携を開発するためのテストモードはありますか?

はい。サポートに依頼すれば開発用アカウントをサンドボックスモードに切り替えられ、番号とコードはすべて模擬となり、ウォレットは減りません。

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