シント・マールテン(+1 721)認証テストの事前チェックリスト

始める前に:+1 721のテストで確認すること

シント・マールテンは北米番号計画の中にあり、その規模以上に多くのテストスイートをつまずかせます。まず次のリストを確認してください。

• 地域の判定。 +1 721で始まる番号は、米国ではなくシント・マールテンのものです。お使いの電話番号ライブラリが、地域SXにマッピングしていることを確認してください。
• 書式。 E.164は+1721に7桁を続けた形で、国内では(721)と7桁の番号で表記されます。入力のスペース、括弧、ダッシュは取り除いてください。
• 国のリスト。 国選択に、島のフランス側であるサン・マルタン(+590を使用)とは別に、シント・マールテンが載っていることを確認します。
• 文面と言語。 オランダ語と英語が公用語で、日常語は英語なので、コードは通常英語で届きます。
• サービスの利用可否。 テスト対象のアプリが、このルートのライブリストに載っていることを確認します。

シント・マールテンの番号でコードを受信できるサービスは?

現在のスナップショットには、WhatsApp、Facebook、Instagram、Google (Gmail & YouTube)、Airbnb、Uber、Amazon、Netflix、Telegram、TikTok、Snapchat、eBay、Microsoft & Outlookが含まれており、観光で成り立つ島のフローを確認する旅行やホスピタリティのチームに向いています。このルートは全体で200を超えるサービスをカバーしています。

大きな市場よりカタログは小さく、頻繁に変わります。実行前にGET /api/v1/countriesとGET /api/v1/servicesに問い合わせてください。サービスがない場合は、キュラソーやアンギラといった近隣のカリブ海のルートが、そのシナリオで確認する価値があるかもしれません。

手順:APIで+1 721の番号を注文する

1. Developerコンソールでキー(or_live_で始まる)を発行し、Bearerトークンとしてhttps://otproute.com/api/v1に送ります。
2. 価格を読み取ります:GET /api/v1/prices?country=sx&service=airbnb。
3. 注文します:POST /api/v1/activationsに{"service": "airbnb", "country": "sx"}。
4. 返された番号を、アプリの認証画面に入力します。
5. activation.sms_receivedのWebhookでコードを受け取るか、GET /api/v1/activations/{id}をポーリングします。
6. X-OTPRoute-Signature(エンドポイントのシークレットによる<t>.<raw body>のHMAC-SHA256)を検証し、古いタイムスタンプは拒否します。

カリブ海の小さなルートでは、アカウントの制限が問題になることはまれですが、キー10個、Webhookエンドポイント5つ、毎分300リクエストです。CIのパターンについては、CIパイプラインでのOTPテストとドキュメントをご覧ください。

手順:開発者でない人向けのダッシュボード経由

サポート担当者やマーケターも、コードなしで同じことができます。サインインし、シント・マールテンとサービスを選んで、注文を押します。番号をアプリにコピーしたら、ダッシュボードを開いたままにしてください。届いたらコードがそこに表示されます。確定する前に価格が表示されます。

この方法は、たとえばリリース後も、ホテルパートナーのスタッフアカウントがシント・マールテンの番号で認証できるかを、エンジニアリングにスクリプト化を頼まずに確認するといった、単発のチェックに便利です。

シント・マールテンのコードが届かない場合のトラブルシューティング

各アクティベーションには20分のウィンドウがあります。その間に何も届かない場合、またはPOST /api/v1/activations/{id}/cancelでキャンセルした場合は、全額が自動的にウォレットへ返金されます。

• 失敗と判断する前に、ウィンドウの時間を使い切ってください。
• サービスが仮想番号を受け付けるか確認します。拒否するものもあります。
• ループで再注文するのではなく、時間を置くか別のサービスルートを使ってください。
• 送信前にアプリが番号を拒否した場合は、地域の判定を調べてください。すべての+1番号を米国かカナダのものと決めつけるバリデーターは、ここで誤作動します。

+1 721なら、Dedicated Numberが利用できますか?

いいえ。+1のプレフィックスが共通でも、シント・マールテンがDedicated Numbersプログラムの対象になるわけではありません。長期用の回線は、受信SMS、Webhook転送、ブラウザ通話付きで、月額$1.95から、米国とカナダでのみセルフサービスで販売しています。詳細は仮想番号をご覧ください。シント・マールテンにはセルフサービスの長期用回線がありません。[email protected]にメールで問い合わせできますが、可能かどうかは現地の規則次第です。

課金とサンドボックス

OTP Routeは、月額料金のない前払いUSDウォレット1つで運用します。カードまたはUSDT/USDCでチャージすると、チャージごとにPDFの請求書がメールで届きます。開発アカウントはリクエストによりサンドボックスへ切り替えられ、模擬の番号とコードで連携をテストできます。

番号は、ご自身のプロダクトと正当なビジネスアカウントにのみ使用し、各サービスの利用規約を守り、利用規約(Acceptable Use Policy)の範囲内でご利用ください。

よくある質問

+1 721の番号は米国の番号として扱われますか?

いいえ。北米番号計画の中の、シント・マールテンの市外局番です。バリデーターでは地域SXとして分類してください。

OTP Routeはシント・マールテンにどの国IDを使いますか?

IDはsxで、POST /api/v1/activationsなどの呼び出しで使います。

現地のSIMなしで、予約アプリのシント・マールテン向けサインアップをテストできますか?

はい。そのサービス用に一時的な+1 721の番号を注文して入力し、ダッシュボードまたはAPIでコードを確認します。

シント・マールテンのサービス一覧が他の国より短いのはなぜですか?

小さなルートのカバー範囲は頻繁に変わります。APIまたはダッシュボードでライブのリストを確認し、必要なら近隣のルートを検討してください。

シント・マールテンの番号にコードが届かなかった場合、支払いは発生しますか?

いいえ。SMSが届かないまま20分のウィンドウが終わったとき、またはキャンセルしたときは、全額がウォレットに戻ります。

シント・マールテンの認証番号はいくらですか?

料金は1コード$0.20〜で、サービスによって異なります。注文の前にAPIが正確な金額を返します。

島のフランス側も同じルートでカバーされますか?

いいえ。サン・マルタンは別の番号ゾーンである+590を使うため、テストでは別の国として扱ってください。

アプリの電話番号欄は、(721)と7桁で入力された番号を受け付けるべきですか?

はい。国内の書式を受け付けたうえで、保存または送信の前に+1721に7桁を続けた形へ正規化してください。

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