OTP Routeでマラウイの認証コードを受信する

テスト用の+265番号で認証できるアプリは？

マラウイ向けのOTPルーティングは、現在1,700を超えるサービスに対応しています。現在のスナップショットで人気のあるものは、Facebook、WhatsApp、TikTok、Telegram、Google（Gmail＆YouTube）、Instagram、Snapchat、LinkedIn、Microsoft＆Outlook、ChatGPT（OpenAI）、Viber、imoです。状況は時間ごとに変わるため、夜間に走るジョブは、設定ファイルに貼り付けた一覧ではなく、GET /api/v1/servicesとGET /api/v1/pricesから最新の可用性を読み取ってください。

マラウイのコードを自社のシステムに取り込むには？

国IDとしてmwを渡し、SMS認証APIをマラウイのルートに向けます。一般的な手順は次のとおりです。

1. GET /api/v1/prices?country=mw&service=facebookで、その組み合わせの現在の価格を読み取ります。
2. POST /api/v1/activationsに{"service": "facebook", "country": "mw"}を渡して、番号を確保します。
3. 返された+265番号を、テスト対象のアプリに入力します。
4. エンドポイントに届くactivation.sms_receivedイベントを待ちます。エンドポイントを運用していない場合は、代わりに数秒おきにGET /api/v1/activations/{id}を照会します。

キーのプレフィックスはor_live_で、開発者コンソールで作成します。マラウイ向けのジョブも、1アカウント全体で1分あたり300リクエストという枠を共有し、これは最大10個のキーと5つのWebhookエンドポイントにまたがって使われます。同じ流れをより詳しい背景とともに説明しているのが、API連携ガイドです。

技術者でなくてもマラウイのルートは使えるか？

はい。運用やサポートのスタッフは、ブラウザの中だけで完結できます。OTP Gatewayを開き、サービスを選び、マラウイを選択して、価格を確認し、確定します。番号はすぐに表示され、テキストが着信するとその横にコードが現れます。インストールするものは何もなく、1つのウォレットでダッシュボードの注文もAPI呼び出しも賄えます。

マラウイ向けの電話番号欄は何を受け付けるべきか？

マラウイの携帯番号は、+265の後ろに9桁が続きます。国内では、先頭にトランクプレフィックスの0を付けて書くのが一般的なので、ユーザーは0に9桁を入力することも、+265に9桁を入力することもあります。両方を受け付け、国番号があるときは0を外して、E.164形式で保存してください。公用語は英語で、チェワ語も広く話されています。国際的なアプリからの認証テキストは、通常英語で届くので、特定の文言に頼らず、数字の並びを抜き出すパーサーにしてください。

チームがマラウイでアカウントを認証するのはなぜか？

アフリカ南部でフィールドプログラム、モバイルマネー、農業プラットフォーム、地域のサポートデスクを運営する組織は、マラウイのユーザーに対してオンボーディングが機能する証拠を求めることがよくあります。QAエンジニアがマラウイの認証番号を使うのは、+265のプレフィックスでしか現れないバグを捕まえるためです。たとえば、マラウイが抜けた国の選択リスト、10桁の番号を前提にした桁数ルール、ローカライズすると壊れるテンプレートなどです。このようなケースをさらに挙げているのが、モバイルアプリ認証のページです。

SMSが届かない場合は？

境界になるのは20分のウィンドウです。SMSが届かないままウィンドウが閉じたとき、または早めにキャンセルしたときは、全額が自動でウォレットに戻ります。待っている間は、次を確認してください。

• 選んだサービスが、仮想番号へのSMS送信に応じるか確認します。
• 新しい注文を立て続けに出さず、ウィンドウが終わるのを待ちます。
• 時間をおいて再試行するか、同じサービスで別のルートを試します。
• イベントをテストケースと照合できるよう、アクティベーションIDをログに残します。

地域のテストが、マラウイそのものに依存しないのであれば、ザンビアのような隣接するルートも検討する価値があります。

長期回線、課金、サンドボックス

セルフサービスで利用できる+265の長期番号はありません。Dedicated Virtual Numbersは米国とカナダ向けの製品で、$1.95/月からです。マラウイの回線については、[email protected]にメールできますが、結果は現地の規則によるため、お約束はできません。課金は、月額料金もプランもないプリペイドのUSDウォレットで行い、カードまたはUSDT/USDCでチャージし、チャージごとにPDFの請求書が発行されます。OTP Gatewayの料金は$0.20/コードからです。構築中に模擬の番号とコードが必要なら、サポートに依頼して開発用アカウントをサンドボックスにしてもらうか、アカウントを作成して始めてください。

よくある質問

マラウイにいなくても、マラウイのSMS OTPを受信できるか？

はい。番号は提携キャリアのネットワーク上にあるので、どこからでも注文でき、ダッシュボードまたはAPIでコードを読み取れます。

OTP Route APIで、マラウイの国IDは何か？

mwです。POST /api/v1/activationsのcountryフィールドと、価格の照会で渡します。

マラウイの認証番号はいくらか？

料金は$0.20/コードからで、サービスにより異なります。最新の金額は価格エンドポイントから返され、注文前にダッシュボードにも表示されます。

マラウイの番号の先頭の0は保存すべきか？

いいえ。E.164形式の+265に9桁を続けた形で保存し、ユーザーが入力したトランクの0は破棄してください。表示用の整形は別に扱います。

マラウイのアクティベーションは、どのくらい開いたままか？

20分間です。その間に何も届かなければ、料金は何もしなくてもウォレットに返金されます。

後のログインのために+265番号を保持できるか？

セルフサービスの製品としてはできません。長期番号があるのは米国とカナダだけです。マラウイについては、[email protected]にメールでお尋ねください。

お金をかけずに連携をテストするには？

開発用アカウントにサンドボックスモードをリクエストします。模擬の番号とコードが返されるので、Webhook、リトライ、タイムアウトをエンドツーエンドで試せます。

どのような使い方が許されているか？

自社の製品と、正当な業務用アカウントの認証です。各アプリの規約を守ってください。OTP RouteのAcceptable Use Policyはすべての注文に適用され、複数アカウントを作る行為は認められていません。

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