サン・バルテルミー島(+590)の認証コードを受信するためのチェックリスト

+590番号を注文する前の、事前チェックリスト

サン・バルテルミー島はOTP Routeでも小さなルートの1つなので、少し準備しておくと無駄な試行を減らせます。

• サービスが今日一覧にあるか確認する。 GET /api/v1/countries と GET /api/v1/services を呼び出すか、ダッシュボードを開きます。国IDは bl です。
• 価格を確認する。 GET /api/v1/prices?country=bl&service=<id> が、その組み合わせの最新の金額を返します。
• ウォレットにチャージする。 自動ジョブでは、先に GET /api/v1/balance を確認します。
• 電話番号の入力欄を準備する。 国番号の後に9桁が続く+590番号を受け付けるようにします。
• サービスの方針を把握する。 仮想番号を拒否するサービスもあります。
• 代替ルートを用意しておく。 ここでは対応状況がよく変わります。

このモデルが初めての方は、OTPゲートウェイとは何かで基本を説明しています。

サン・バルテルミー島の番号にコードを送れるサービスは?

このルートでは現在、20を超えるサービスが一覧に載っていますが、大きな市場に比べるとカタログはかなり短いです。最新のスナップショットには、TikTok、Amazon、LinkedIn、AliExpress、Flipkart、Mercado Libre、Mercado Pago、Coinbase、Bumble、Swiggyが含まれています。

一覧は短く、1日の中で変わるため、利用可否は必ず注文時にAPIで確認してください。必要なサービスが見つからない場合は、+590の国番号を共有する近隣のグアドループのルートや、フランス語のテストならフランスのルートが合うかもしれません。

手順で見る、サン・バルテルミー島のOTPルーティングのAPIフロー

1. or_live_ で始まるBearerキーで、https://otproute.com/api/v1 に認証します(1アカウントにつきキー10個まで、毎分300リクエストまで)。
2. 注文します。POST /api/v1/activations に {"service": "linkedin", "country": "bl"} を送り、返されたアクティベーションIDと番号を保持します。
3. +590の番号を、テスト中のアプリまたはサイトに入力します。
4. +590のコードは、activation.sms_received イベントで受け取るか、数秒おきに GET /api/v1/activations/{id} をポーリングする方法に切り替えます。
5. t=<unix>,v1=<hex> の形式の X-OTPRoute-Signature ヘッダーを、エンドポイントのシークレットによる "<t>.<raw body>" のHMAC-SHA256を計算して検証し、古いタイムスタンプは拒否します。
6. テストが途中で終わる場合は、POST /api/v1/activations/{id}/cancel でキャンセルします。

キー、Webhook、サンプルは、開発者向け概要に1か所にまとめてあります。

+590の番号は、どのように書式化して保存しますか?

サン・バルテルミー島は、グアドループやサン・マルタン島のフランス領部分と並んで+590の国番号を使い、フランスの番号の慣習に従います。国内では、番号は国内プレフィックスの 0 を付けた10桁で表記され、固定電話は通常0590、携帯電話は0690で始まります。E.164では 0 を取り除くので、携帯電話は +590 690 に6桁を続けた形になります。

多くのチームが見落とす点が1つあります。国番号だけでは、顧客がどの地域に住んでいるかは分かりません。プロダクトが地域ごとのコンテンツを表示する場合は、+590から推測せず、地域を別に尋ねてください。E.164の文字列はスペースなしで保存し、地域は別のフィールドとして持ちます。

公用語はフランス語なので、コードのメッセージは、送信元サービスのローカライズの仕方によって、通常フランス語または英語で届きます。

チームがサン・バルテルミー島でテストや運用を行うのはなぜですか?

島の経済は観光が中心なので、旅行、ヴィラ貸し出し、コンシェルジュ、ボートチャーター、ホスピタリティのアプリが、典型的な理由です。+590番号を持つ宿泊客や現地スタッフがサインアップを完了できるかを確認したいチームもあれば、ホテルのカリブ海向けキャンペーンを運用する代理店が、現地のクライアントのビジネスプロフィールを認証することもあります。カリブ海のフランス語フローのローカライズQAも理由の1つで、この用途は運用チーム向けのページで扱っています。

トラブルシューティング:コードが届かなかった場合

各アクティベーションの有効時間は20分で、課金されるのはコードが届いたときだけです。何も届かずに時間が終わった場合や、キャンセルした注文は、全額が自動的にウォレットへ返金され、Webhookには activation.expired または activation.cancelled が届きます。

• あきらめる前に、有効時間いっぱいまで待ちます。
• サービスが仮想番号を受け付けるか確認します。
• 後で再試行するか、別のサービスルートや近隣の国に切り替えます。
• 短い間隔で再注文せず、試行の間に間隔をあけます。

コードを書かない手順:メールと6桁のメールコード、またはGoogleサインインでサインアップし、TOTPを有効にしてチャージし、サン・バルテルミー島とサービスを選び、表示された価格を承諾して、ダッシュボードでコードを読み取ります。

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

サン・バルテルミー島には、セルフサービスの長期番号はありません。専用回線は米国とカナダ向けの製品で、月額$1.95からです。継続して使える+590の回線については、[email protected] にメールで問い合わせてください。ただし、提供の可否は現地の規則によるため、保証はできません。

お支払いは、1つのプリペイドUSDウォレットによる従量課金で、月額料金やプランはありません。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届きます。開発アカウントはサンドボックスモードを依頼でき、シミュレートされた番号とコードが返るため、資金を使わずに連携をエンドツーエンドでテストできます。

+590番号は、自社の製品とアカウントにのみ使用し、各サービスの利用規約を守ってください。OTP Routeの利用規定(Acceptable Use Policy)が適用されます。

よくある質問

現地のSIMなしで、サン・バルテルミー島の認証コードを受信できますか?

はい。その時点でサービスがルートにあれば受信できます。OTP Gatewayで+590番号を注文し、ダッシュボードまたはAPIでコードを読み取ります。

サン・バルテルミー島のAPI国IDは何ですか?

bl です。そのため、注文のボディは {"service": "tiktok", "country": "bl"} のようになります。

サン・バルテルミー島のサービス一覧が短いのはなぜですか?

小さなルートで、対応状況がよく変わるためです。現在の一覧は GET /api/v1/countries またはダッシュボードで確認し、代替としてグアドループやフランスも検討してください。

+590は、常に顧客がサン・バルテルミー島にいることを意味しますか?

いいえ。グアドループとサン・マルタン島のフランス領部分も+590を共有しているため、プロダクトにとって重要なら、地域を別に収集してください。

テスト用の+590番号には、いくらかかりますか?

1コード$0.20からで、正確な金額はサービスごとに決まり、注文前にAPIがリアルタイムで返します。

コードが届かなかった場合、お金を失いますか?

いいえ。SMSが届かないまま20分が過ぎた場合や、キャンセルした場合は、全額がウォレットに戻ります。

繰り返しのログイン用に、サン・バルテルミー島の番号を保持できますか?

セルフサービスでは提供していません。専用番号は米国とカナダでのみ利用できます。他の選択肢については、[email protected] にメールでお問い合わせください。

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