QAと運用におけるモルディブ(+960)ワンタイムコードの扱い方

状況の整理:旅行・ホスピタリティ製品を+960のユーザーに対応させる

マレや環礁各地のゲストやパートナーに対応しようとしている予約プラットフォーム、リゾート運用ツール、デリバリーアプリを想像してください。エンジニアは別の国に住んでおり、認証画面はもっと長い番号を前提に設計されていて、モルディブのSIMを持つメンバーは誰もいません。ローンチ前に電話番号の手順が動くことを誰かが証明する必要があります。

OTP Gatewayが埋めるのはまさにこの隙間です。1回の認証のために本物の+960番号をテストに渡すので、渡航もローミングも同僚の携帯の借用もなしに、ステージングや本番のサインアップフローでモルディブのSMS OTPを受信できます。

利用の理由は大きく3つです。観光色の強い市場のローカライズQA、南アジアとインド洋地域へのリージョナルなローンチ、そして特定の個人番号に紐づけずに会社のアカウントを認証したい運用チームです。より広いワークフローはQAテストのページで説明しています。

なぜ7桁のモルディブ番号が検証コードでつまずくのですか?

モルディブはクローズド番号計画を採用しており、+960の後に7桁が続き、付け外しするトランクプレフィックスはありません。この短さが、多くのフォームでつまずく原因になります。国内番号を9桁以上と想定した正規表現や、別のデフォルト地域で設定されたライブラリは、有効な番号を拒否してしまいます。

テストスイートに加えておきたいチェックを挙げます。

• +960 の後に7桁が続く形式と、7桁だけの国内形式の両方を受け付け、保存前にE.164へ正規化する。
• 復元すべきトランクプレフィックスがないため、どの処理も0を挿入していないことを確認する。
• 確認画面や領収書で番号が正しく表示されることを確認する。

国語のディベヒ語は右から左に書くターナ文字で表記され、ビジネスや観光では英語が広く使われます。海外アプリの認証SMSは多くが英語で届きますが、ローカライズされたテンプレートでもパーサーが壊れないよう、文言の照合ではなく数字の抽出でコードを取り出してください。

現在、+960の番号で認証できるサービスは?

現在のモルディブのルートは1,700を超えるサービスに対応しています。現在のスナップショットに含まれる名前は、WhatsApp、Telegram、Viber、Instagram、Facebook、Airbnb、Uber、Google(Gmail & YouTube)、LinkedIn、Microsoft & Outlook、Snapchat、TikTok、Claude、Netflixなどです。

旅行系プロダクトでは、予約サービスやメッセージサービスと自社アプリを組み合わせるのが有効です。ゲストの番号が両方でどう動くかを確認できます。利用可否は一日の中で変わるため、APIは固定リストではなくリアルタイムのデータを返します。カタログ全体はサービスにあります。

モルディブOTP APIを自動テストに組み込む

Developerコンソールでキーを作成します。キーは or_live_ で始まり、Bearerトークンとして https://otproute.com/api/v1 に送ります。モルディブの国IDは mv です。

1. GET /api/v1/prices?country=mv&service=airbnb で、注文の費用と在庫の有無を確認します。
2. POST /api/v1/activations に {"service": "airbnb", "country": "mv"} を送り、アクティベーションIDと+960番号を受け取ります。
3. その番号をテスト対象のフローに入力します。
4. activation.sms_received がエンドポイントに届いた時点、または代わりに GET /api/v1/activations/{id} をポーリングして、+960のコードを取得します。
5. モルディブのテストが途中で中断した場合は POST /api/v1/activations/{id}/cancel を送ると、ウォレットに即座に返金されます。

署名付き配信には t=<unix>,v1=<hex> 形式の X-OTPRoute-Signature が含まれます。エンドポイントのシークレットを使って、タイムスタンプ、ドット、生のボディのHMAC-SHA256を計算し、比較して、古いタイムスタンプは拒否してください。Webhookエンドポイントは最大5つまで登録でき、1分あたり300リクエストまで利用できます。このモルディブOTP APIのフィールドレベルの詳細は開発者ドキュメントにあります。

代わりにダッシュボードから+960番号を取得する

プロジェクトのメンバー全員がコードを書くわけではなく、ダッシュボードでも同じことができます。国にモルディブを選び、サービスを選び、リアルタイム価格を確認すると、番号が画面に表示されます。それをアプリに貼り付けて注文を見守ってください。サービスがSMSを送信すると、同じ行にコードが表示されます。

注文の有効時間は20分です。コードが届いた場合にのみ課金され、キャンセルまたは期限切れの注文は自動的に返金されます。ゲスト向けフローを確認するサポート担当者が、試行のたびに経理の承認を取る必要はありません。

コードが止まったとき:簡単なリカバリー手順

配信時間はサービスとルートによって異なるため、最初の1分が静かでも普通のことです。何も届いていない場合は次のとおりです。

1. ウィンドウが閉じる直前まで待ちます。
2. 日中の時間帯を変えて再試行するか、別のサービスルートでテストします。
3. 対象のサービスが仮想番号を受け付けているか確認します。ポリシーとして拒否するサービスもあります。
4. 新規注文を短時間に連続して出さないでください。レート制限を消費するだけです。

OTPのための国別ルーティングの記事では、1つの国のルートが手薄なときに別のルートへフォールバックする方法を説明しています。

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

OTP Routeには、モルディブ向けのセルフサービスの長期番号はありません。チームで保持できる回線が必要な場合は [email protected] までご連絡ください。可否は現地の規則によります。月ごとに更新して保持できるDedicated Numbersは、米国とカナダのみで、$1.95/月からです。

課金は1つのプリペイドUSDウォレットから行われ、サブスクリプションやプランの階層はありません。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届きます。開発者は開発アカウントにサンドボックスモードを依頼でき、シミュレートされた番号とコードで連携をテストできます。

利用は正当な範囲にとどめてください。自社製品のテストに使い、各サービスの規約に従ってください。なお、OTP Routeの利用規定(Acceptable Use Policy)はすべての注文に適用されます。

よくある質問

モルディブの電話番号は何桁ですか?

国番号+960の後に7桁で、トランクプレフィックスはありません。バリデーションはこの短い桁数を受け付けるようにしてください。

モルディブのAPI国IDは何ですか?

mv です。GET /api/v1/prices と POST /api/v1/activations のボディに渡します。

モルディブに行かずに、予約アプリの+960サインアップを確認できますか?

はい。OTP Gatewayから使い切りのモルディブ番号を注文してアプリに入力し、ダッシュボードまたはAPIでコードを読み取ります。

モルディブのコードが届かなかった場合、お金はどうなりますか?

課金されません。SMSが届かないまま20分のウィンドウが終了した場合、またはキャンセルした場合は、全額がウォレットに戻ります。

認証メッセージはディベヒ語で届きますか?

海外のサービスの多くは英語で送りますが、文面はアプリによって異なります。どちらの言語でも動くよう、文章ではなく数字を解析してください。

スタッフのアカウント用に+960番号を保持できますか?

セルフサービスでは提供していません。保持できる回線は米国とカナダ向けの製品です。モルディブについては [email protected] にメールでお問い合わせください。

OTP Routeの利用に月額プランは必要ですか?

いいえ。カードまたはUSDT/USDCでチャージするプリペイドUSDウォレットからの従量課金で、チャージごとにPDFの請求書が発行されます。

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