開発者と QA のためのフランス領ギアナ（+594）認証番号

1 回限りのコードか、保持する番号か：フランス領ギアナではどちらが使えるか？

コードを書く前に、その作業にどちらのプロダクトが必要かを決めてください。

• OTP Gateway は 1 回限りの認証に向いています。たとえば、サインアップフローがフランス領ギアナの認証番号を受け付けるかの確認、リリース前のリグレッション実行、現地向けビジネスプロファイルの一度きりの設定などです。各番号で受信できるコードは 1 件です。
• 専用の仮想番号（Dedicated Virtual Numbers） は、コードを受け取り続ける必要があるアカウント、たとえば QA チームが毎週開くステージング用ログインに向いています。即時購入できるのは米国とカナダのみで、月額 $1.95 からです。

フランス領ギアナは前者のグループに入ります。セルフサービスで取得できる長期の +594 回線はありません。必要な場合は [email protected] までご連絡ください。提供可否は現地の規則によります。どちらに当てはまるか迷うときは、一時番号と専用番号の比較が参考になります。

フランス領ギアナの OTP API は、どのような順序で動くのか？

フランス領ギアナの国 ID は gf です。Bearer キー（プレフィックス or_live_）を使い、https://otproute.com/api/v1 に対して次のように進めます。

1. GET /api/v1/prices?country=gf&service=<id> で現在の価格を取得し、そのルートが利用可能かどうかを確認します。
2. POST /api/v1/activations に {"service": "facebook", "country": "gf"} を送ると、+594 の番号が確保され、アクティベーション ID が返ります。
3. テストの中で、その番号をテスト対象アプリに入力します。
4. コードは Webhook の activation.sms_received で届きます。ポーリングする場合は GET /api/v1/activations/{id} を使います。
5. テストで不要になった注文は POST /api/v1/activations/{id}/cancel で解放します。

Webhook リクエストには t=<unix>,v1=<hex> 形式の X-OTPRoute-Signature が含まれます。エンドポイントのシークレットで "<t>.<raw body>" の HMAC-SHA256 を計算し、定数時間で比較して、古いタイムスタンプは拒否し、アクティベーション ID で重複を排除してください。1 アカウントあたりの上限は、API キー 10 個、Webhook エンドポイント 5 個、1 分あたり 300 リクエストです。詳しいリファレンスはドキュメントにあります。

+594 の番号が電話番号バリデーションを混乱させるのはなぜか？

フランス領ギアナはフランスの海外地域で、フランスの番号計画に従っていますが、国番号はフランスの +33 ではなく独自の +594 です。国内では先頭に 0 が付く 10 桁で、携帯は通常 0694 から、固定回線は 0594 から始まります。国際形式では 0 を外すため、携帯番号は +594 694 XX XX XX になります。

この仕組みは典型的なバグを生みやすく、+594 のテスト用番号はそれを見つける最も手軽な方法です。

• フランスの海外領土をすべてフランスにまとめ、0694 の番号に +33 を付けてしまう国選択メニュー。
• 電話番号ライブラリは地域を GF と返すのに、業務ロジックは FR しか知らないケース。
• 表示用にフランス式の 2 桁区切りで整形し、E.164 ではなく整形済み文字列を保存してしまう処理。

+594… は空白なしで保存し、データモデルでは地域と国を別の概念として扱ってください。

フランス領ギアナの番号に認証コードを送れるアプリは？

フランス領ギアナのルートでは、現在 700 を超えるサービスを利用できます。直近のスナップショットには、WhatsApp、Facebook、Instagram、Google (Gmail & YouTube)、TikTok、Snapchat、Telegram、Microsoft & Outlook、Amazon、Airbnb、Uber、LinkedIn が含まれます。

SMS の文面は通常フランス語で、現地アカウントの多くが使う言語に合わせられています。ただしテンプレートは各サービスが決めるため、特定のフレーズに一致させるのではなく、数字を抽出してください。チームがここでテストする典型的な場面は、フランス本土以外のフランス語フローのローカライズ、フランス海外地域のお客様への対応、設定変更後に現地アカウントが引き続き認証できるかの確認です。

ダッシュボードから +594 の番号を注文するには？

コードは不要です。

1. メールアドレスと 6 桁のメールコード、または Google ログインで登録し、そのついでに TOTP 二要素認証も有効にします。
2. カード、または USDT/USDC でウォレットにチャージします。
3. フランス領ギアナとサービスを選びます。価格は確定前に表示されます。
4. 番号をアプリに貼り付け、アクティベーションのページでコードを待ちます。

この方法は主に運用担当者や代理店のアカウントマネージャーが使い、エンジニアは API を組み込みます。どちらも同じウォレットを利用します。

コードがいつまでも届かないときは？

アクティベーションの有効期間は 20 分です。課金されるのはコードが届いた場合のみで、キャンセルした注文や、SMS が届かないまま期限が切れた注文は、全額が自動的にウォレットへ戻ります。

+594 のコードを待っている場合は、次の点を確認してください。

• 期限が来るまで待ちます。サービス側が遅いだけで、問題がないこともあります。
• そのサービスが仮想番号を受け付けるか確認します。受け付けないサービスもあり、返金はまさにその場合のためにあります。
• 時間をおいて再試行するか、別のサービスルートを選びます。
• 失敗のたびに即座に再注文するスクリプトは避けてください。指数バックオフを使うことで、+594 ルートを皆が使い続けられます。

さらに詳しくは、OTP 配信失敗を減らす方法をご覧ください。フランス領ギアナでのテストは、自社が所有するプロダクトとアカウントに限り、各サービスの利用規約を守り、OTP Route の利用規定（Acceptable Use Policy）も契約の一部として扱ってください。

支払い、請求書、サンドボックスでのテストはどうなっているか？

OTP Route はプリペイドの USD ウォレットで動きます。従量課金で、月額料金もプランもありません。チャージはカード、または USDT/USDC のステーブルコインで行い、チャージのたびに経理向けの PDF 請求書がメールで届きます。現在の料金は料金ページに掲載されています。

gf のフローを組み込むエンジニアは、サポートに依頼して開発用アカウントをサンドボックスに切り替えられます。サンドボックスではシミュレートされた番号とコードが返るため、+594 のフロー、Webhook の検証、リトライのロジックを、ウォレットの資金を使わずにエンドツーエンドで試せます。API から見れば、フランス領ギアナへの OTP ルーティングは他の市場と変わりません。変わるのは国 ID だけで、SMS 認証 API は同じです。

よくある質問

現地の SIM なしで、フランス領ギアナ向けのサインアップをテストできますか？

はい。gf 向けの OTP Gateway 番号を注文し、サインアップフォームに入力して、コードをダッシュボードまたは Webhook から読み取ります。

フランス領ギアナの番号は、フランスの +33 番号と同じですか？

いいえ。フランス領ギアナはフランスの番号計画を使っていますが、国番号は独自の +594 で、電話番号ライブラリも別の地域として扱います。

+594 のコードはいくらですか？

1 コード $0.20 からで、サービスによって異なります。ライブ価格はダッシュボードと GET /api/v1/prices で確認できます。20 分以内に SMS が届かなければ自動で返金されます。

フランス領ギアナの番号を、後のログインのために保持できますか？

セルフサービスの方法はありません。長期の専用番号は米国とカナダに限られます。+594 については [email protected] までお問い合わせください。

コードは何語で届きますか？

通常はフランス語ですが、各サービスが独自のテンプレートを選び、アカウントの言語設定に従う場合もあります。

ウォレットにチャージする前に、連携をテストできますか？

開発用アカウントのサンドボックスモードを依頼してください。番号とコードがシミュレートされ、費用をかけずにフロー全体を試せます。

フランス領ギアナのコードが届かなかったのはなぜですか？

サービスの遅延、仮想番号の拒否、ルートの混雑などが考えられます。有効期間が終わるまで待ち、その後に時間をおいて、または別のルートで再試行してください。失敗した注文は返金されます。

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