プロダクト・QAチームのためのモナコ(+377)認証コード

チームがモナコの番号でテストするのはなぜ?

モナコは小さな国ですが、プライベートバンキング、ホスピタリティ、ヨットのサービス、国際イベントに携わる企業にとっては、その規模以上の存在感があります。現地の顧客は、プロダクトが+377番号を問題なく受け付けることを期待しており、リビエラ周辺の人なら誰でもフランスの+33回線を持っていると想定しているフォームが、意外にもまだ多く残っています。

その想定は、実際のサポートチケットを生みます。モナコで働く多くの人は国境を越えたフランス側に住んでフランスの番号を持ち、居住者はモナコの番号を持っているため、1つの顧客基盤に両方の国番号が混在します。+377のテスト用番号として注文するモナコの認証用番号があれば、QAエンジニアは、国選択、入力検証のルール、SMSテンプレートが、この公国をフランスの郊外ではなく、独立した国として扱っていることを確認できます。

フォームは+377番号をどう保存・検証すべき?

モナコにはフランスとは別の独自の国番号があり、国内番号はヨーロッパの多くの国に比べて短いです。国際形式ではトランクプレフィックスがなく、番号は+377に、加入者の桁がそのまま続きます。

エンジニア向けの実践的なルールを挙げます。

• 番号はE.164形式(+377…)で保存し、見やすいグループ表記は表示時にのみ適用します。
• フランス式のダイヤルに慣れたユーザーは、習慣で先頭に0を入力することがあります。検証で失敗させるのではなく、正規化の際に取り除いてください。
• +33のプレフィックスとモナコの郵便住所から国を推測しないでください。電話の国と請求先の国は、独立したフィールドとして保持します。
• 手書きの桁数チェックではなく、メンテナンスされている電話番号ライブラリを使ってください。フランスの桁数を固定で書き込むと、有効なモナコの番号が弾かれるためです。

公用語はフランス語なので、認証テキストは通常フランス語で届きますが、現地ではイタリア語と英語も広く使われており、アカウントのロケールがそう設定されていれば、多くのアプリが英語で送信します。オンボーディングをローカライズしている場合は、両方をテストしてください。

モナコのルートで認証できるサービスは?

モナコのルートでは現在、1,300を超えるサービスが利用できます。今回のスナップショットで人気のものには、Instagram、Airbnb、Telegram、Claude、WhatsApp、Facebook、Google (Gmail & YouTube)、Uber、Netflix、eBay、LinkedIn、X (Twitter)があります。

カバレッジは固定ではありません。キャリアパートナーが一日の中で容量を入れ替えるため、午前中に見えていたサービスが、午後には一時停止していることもあります。優れたOTPルーティングは、キャッシュした一覧に頼らず、注文時に利用可否を読み取ります。SMS認証APIは、まさにそれを価格エンドポイントを通じて公開しています。

モナコのOTP APIはどのような手順で動く?

リクエストは https://otproute.com/api/v1 に送り、Developerコンソールで作成した or_live_ で始まる Bearer キーで認証します。モナコの国IDは mc です。

1. 名前をIDに対応づけるため、ときどき GET /api/v1/services と GET /api/v1/countries を取得します。
2. 注文のたびに、GET /api/v1/prices?country=mc&service=<id> を呼びます。リアルタイムの価格と、その組み合わせに対応できるかが返されます。
3. {"service": "airbnb", "country": "mc"} のような本文で POST /api/v1/activations を送って注文します。返されたアクティベーションIDを保持します。
4. +377番号をアプリに入力し、Webhookで activation.sms_received を待つか、GET /api/v1/activations/{id} をポーリングします。
5. 後片付けでは、保留中のものに POST /api/v1/activations/{id}/cancel を呼びます。

各Webhookの X-OTPRoute-Signature ヘッダーは、エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を再計算して検証し、古いタイムスタンプは拒否してください。1アカウントで5つのWebhookエンドポイントを登録でき、毎分300リクエストまで送信できるため、モナコの並列実行にも余裕があります。連携ガイドでは、同じ手順をエラー処理とあわせて解説しています。

運用担当者向けのノーコードの方法はある?

APIに触れたくない人のために、ダッシュボードで同じ経路を利用できます。OTP Gatewayでモナコを選び、サービスを選択して、表示された価格を確認し、確定します。+377番号がアクティベーションカードに表示されるので、ログインまたは登録画面に貼り付けると、SMSが届いた時点でそのカードにコードが現れます。

有効時間は20分です。時間内にコードが届かなかった場合、または注文をキャンセルした場合は、サポートへの依頼なしで、全額がウォレットに返金されます。

モナコのコードが届かないときは?

小さな市場ではルートが少ないため、大きな国よりも、忍耐と代替策の準備が重要になります。

• キャンセルする前に、注文に有効時間いっぱいを与えます。
• そのアクションで、サービスが仮想番号を受け付けるかを確認します。完全に拒否するサービスもあります。
• ループで再注文せず、間を置いてから再試行します。サービス側のレート制限に触れる可能性があるためです。
• テストにリビエラ周辺の番号があれば足りる場合は、その時点ではフランスのルートやイタリアのルートのほうが容量に余裕があるかもしれません。

すべてのテストは、サービスの規約の範囲内で行ってください。OTP Routeは、自社のプロダクトと正当な業務アカウントの検証のためのもので、Acceptable Use Policyが適用されます。

モナコの番号を長期で維持できる? 課金はどうなる?

セルフサービスの長期+377回線はありません。更新しながら維持でき、受信SMS、送信SMS、ブラウザ通話に対応する専用バーチャル番号は、米国・カナダ向けの製品で、月額$1.95からです。モナコの回線については [email protected] にメールしてください。現地の規制で何かが可能かどうかをチームがお伝えしますが、提供の約束はありません。

モナコの注文は、他のすべてと同じ前払いのUSDウォレットから引き落とされ、月額料金もプランの選択もありません。カードまたはUSDT/USDCで入金でき、入金のたびにPDFの請求書がメールで届きます。連携の開発中は、ご依頼により開発用アカウントをサンドボックスに切り替えられ、シミュレートされた番号とコードが返るので、無料でエンドツーエンドのテストができます。詳細は料金ページにあります。

よくある質問

モナコの電話番号は、フランスの番号と同じですか?

いいえ。モナコは独自の+377の国番号を使うため、入力検証のロジックは、フランスの+33とは別に扱う必要があります。

OTP Route APIでのモナコの国IDは何ですか?

価格のクエリとアクティベーションのリクエスト本文には、mc を使います。

ヨーロッパでの展開のテスト用に、+377番号を取得できますか?

はい。OTP Gatewayは、1回の認証用に、ダッシュボードまたはAPIから注文できる+377のワンタイム番号を発行します。

モナコのコードを受信できる時間はどのくらいですか?

各アクティベーションは20分間開いています。何も届かなければ、課金は自動的に返金されます。

モナコの番号にはトランクプレフィックスが含まれますか?

国際形式では含まれません。ユーザーが入力した先頭の0は取り除き、+377に加入者の桁を続けた形で保存してください。

モナコのサービスからの認証SMSは、何語で届きますか?

通常はフランス語ですが、アプリとアカウントの言語設定によって決まるため、英語やイタリア語のテキストの可能性もあります。

実際の資金を使わずに、モナコのテストを実行できますか?

開発用アカウントのサンドボックスモードを依頼してください。連携テスト用に、シミュレートされた番号とコードが返されます。

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