マルティニークのユーザー向け+596電話認証をテストする

なぜマルティニークは、フランスだけを想定した電話番号の検証を壊すのですか?

マルティニークはフランスの一部であり、EUの一部でもありますが、+33ではなく独自の国番号+596を持っています。この組み合わせが古典的なバグを生みます。フランス向けプロダクトが電話番号欄を+33に限定したり、国ピッカーがマルティニークをフランスの下に隠したりすると、島の顧客はサインアップを完了できません。

現地の番号はフランスの10桁形式にならい、トランクの 0 を使います。携帯番号は通常 0696 または 0697 に6桁を続けて書き、固定電話は 0596 です。E.164ではゼロを外して国番号を付け、携帯は +596 696 xx xx xx になります。固定電話の癖にも注意してください。+596 596… は数字が重なるため、自作のバリデーターがタイプミスと誤判定することがあります。

• +596 に9桁を続けた形で保存し、スペースは画面表示のときだけ付けます。
• 島を選択した状態で 0696… と入力された場合は、トランクのゼロを取り除きます。
• +596、グアドループ(+590)、仏領ギアナ(+594)が、それぞれ別の国番号として受け付けられることをテストします。

誰が+596番号をテストに必要としますか?

公用語はフランス語で、マルティニーククレオール語も広く話されますが、海外アプリからの認証SMSは、アカウントのロケールに応じてほぼ必ずフランス語か英語で届きます。そのため、すでにフランス向けにローカライズしているチームにとって、マルティニークは有用な確認先になります。

• 海外在住者を国内顧客として扱う必要がある、フランスとEUでのローンチ。
• 島で使われる旅行、デリバリー、ホスピタリティ製品のカリブ海での運用。
• 電話番号のパース、SMSテンプレート、復旧フローを、あまり一般的でない国番号で確認する回帰テストスイート。

こうしたチェックを既存のパイプラインに組み込む方法は、QAテストガイドで説明しています。

マルティニークの番号にコードを送れるサービスは?

マルティニークのルートでは600を超えるサービスが利用できます。現在のスナップショットで人気のものは、WhatsApp、Telegram、Google(Gmail & YouTube)、Facebook、Instagram、TikTok、Microsoft & Outlook、Amazon、Discord、Snapchat、Airbnb、Uber、Netflixなどです。

利用可否は一日の中で変わるので、テスト計画にハードコードせず、必要になった時点でAPIから取得してください。

APIでマルティニークのSMS OTPを受信するには?

DeveloperコンソールでBearerキー(プレフィックス or_live_)を作成し、クライアントを https://otproute.com/api/v1 に向けます。マルティニークの国IDは mq です。

1. GET /api/v1/prices?country=mq&service=<id> で、そのペアのリアルタイム価格と在庫を確認します。
2. POST /api/v1/activations に {"service": "airbnb", "country": "mq"}(またはテスト中のサービス)を送って注文します。
3. 返された+596番号を自社アプリに入力し、コードを送信させます。
4. activation.sms_received を購読したWebhookで受け取るか、数秒おきに GET /api/v1/activations/{id} をポーリングします。
5. テストが早く終わった場合は、POST /api/v1/activations/{id}/cancel でアクティベーションを解放します。

信頼する前に、必ずすべてのWebhookを検証してください。X-OTPRoute-Signature ヘッダーは t=<unix>,v1=<hex> を保持し、v1 はエンドポイントのシークレットをキーとした <t>.<raw body> のHMAC-SHA256です。古いタイムスタンプは拒否し、ハンドラーはアクティベーションIDに対して冪等にしてください。詳細なリファレンスは開発者ドキュメントにあります。

非開発者向けのダッシュボード経路はありますか?

サポート担当者やグロースチームは、ブラウザから同じOTPルーティングを実行できます。メールまたはGoogleでサインアップし、ウォレットにチャージして、マルティニークとサービスを選び、表示された価格を確認して確定します。+596番号が画面に表示され、SMSが届くと同じカードにコードが追加されます。ウィンドウは20分で、SMSが届かない場合やキャンセルした場合は、代金がそのまま残高に戻ります。

+596の認証コードが遅い、または届かない場合は?

小規模なルートは静かなことがあるため、それを前提に計画してください。

• 失敗と判断する前に、ウィンドウの最後まで待ちます。
• サービスが仮想番号を拒否することがあると覚えておいてください。その場合は課金されません。
• 少し間をおいて再試行するか、シナリオが許すなら、グアドループのような近隣ルートを使います。
• 注文エンドポイントを連打せず、再試行の間隔を空けます。

さらに多くの対策は配信失敗のチェックリストにあります。各サービスの規約に従ってください。OTP Routeの利用規定(Acceptable Use Policy)が適用されます。

マルティニークの恒久的な番号は取得できますか?支払いはどうしますか?

マルティニーク向けのセルフサービスの長期番号は提供していません。専用回線は米国とカナダのみで、$1.95/月からです。マルティニークの回線が必要な場合は [email protected] にメールしてください。何が可能かは現地の規則次第です。

支払いは、サブスクリプションなしの1つのプリペイドUSDウォレットで行います。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書が届きます。連携を組み込む間にシミュレートされた番号とコードが欲しい場合は、開発アカウントのサンドボックスモードを依頼してください。

よくある質問

マルティニークの番号はフランスの+33番号と同じですか?

いいえ。マルティニークはフランスの一部ですが独自の国番号+596を使うため、フォームはそれを別途受け付ける必要があります。

マルティニークの携帯番号をE.164で表すとどうなりますか?

先頭のゼロを外して国番号を付けます。0696 xx xx xx と書かれた番号は +596 696 xx xx xx になります。

マルティニークには、どの国IDを送ればよいですか?

価格照会とアクティベーション要求の country 値として mq を送ります。

現地SIMなしで、予約アプリのマルティニーク向けサインアップを確認できますか?

はい。OTP Gatewayでそのサービス用の+596番号を注文し、ダッシュボードまたはAPIでコードを読み取ります。

SMSが届かない+596のアクティベーションにも料金を払いますか?

いいえ。期限切れやキャンセルされたアクティベーションは全額ウォレットに返金され、コードが届いた場合にのみ支払います。

OTP Routeはマルティニークの長期回線を販売していますか?

セルフサービスでは販売していません。長期のDedicated Numbersは米国とカナダ向けの製品です。マルティニークについては [email protected] にメールでお問い合わせください。

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