日本語
ハイチ（+509）の認証番号：プロダクトチームとQAチーム向け
OTP Routeでは、OTP Gatewayから番号を注文し、ダッシュボード、またはREST APIと署名付きWebhookでコードを読み取ることで、ハイチ（+509）の認証コードを受信できます。料金は1コード $0.20 から、番号1つにつき20分以内に1件のコードを処理し、請求されるのはSMSが届いたときだけです。
プロダクトチームがハイチの電話番号をテストするのはなぜですか？
ハイチは、メールアドレスよりも電話番号のほうが大きな役割を果たす市場です。メッセージングアプリは家族、仕事、コミュニティの会話を支えており、ハイチの顧客向けのプロダクトの多くは、米国、カナダ、フランスにいる大規模なディアスポラも想定してつくられています。そのため、送金、モバイルマネー、マーケットプレイス、メッセージングの各チームは、+509番号で登録、ログイン、アカウント復旧ができることを確かめる必要に迫られます。
もう1つの理由は言語です。ハイチ・クレオール語とフランス語がどちらも公用語なので、ローカライズのQAでは、画面、エラーメッセージ、SMSテンプレートがそれぞれの言語で正しく読めるか、フローの途中で言語を切り替えたユーザーにも理解できるコードが届くかを確認することになります。実際のハイチの認証番号でテストするのが、顧客と同じ経路をたどって確かめる最も直接的な方法です。より広い手引きは、モバイルアプリ認証のページをご覧ください。
+509番号の形式と保存方法はどうなっていますか？
ハイチの番号は、国コード+509のあとに8桁が続きます。国内ダイヤルにトランクプレフィックスはなく、国内表記はその8桁だけ、国際表記はその前に+509を付けた形になります。
正規の値はE.164形式（+509 に続けて8桁）で保存し、入力時にはスペース、ハイフン、先頭の 00509 を取り除いてください。ディアスポラの行動にも注意が必要です。海外在住のハイチ人の顧客が、米国やカナダの番号で登録し、あとから+509の回線を追加することもあります。国の選択UIや重複チェックでは、国コードを飾りではなく、識別情報の一部として扱いましょう。
SMSの文面は送信するサービスが決めます。アプリやアカウントの言語によっては、ハイチの番号に届くコードがフランス語、英語、またはそのサービスが対応するほかの言語になることもあるので、前後の言葉に関係なく数字を抽出できるパーサーにしてください。
ハイチの認証番号にコードをSMS送信できるサービスは何ですか？
現在、+509のルートでは1,000を超えるサービスに対応しています。ライブのスナップショットには、WhatsApp、Facebook、Instagram、Telegram、Google（Gmail & YouTube）、Microsoft & Outlook、TikTok、X（Twitter）、Snapchat、Signal、Viber、Amazon、Netflix、eBayが含まれます。
これらの名前は、固定のメニューではなく、+509番号で一般的に扱えるものの例として受け取ってください。在庫は一日の中で変動するため、APIとダッシュボードには、お問い合わせの時点で利用できるものが表示されます。仮想番号を拒否するサービスもあり、自動返金はまさにそのケースのための仕組みです。サービス名はそれぞれの所有者に帰属し、これらのサービスと当社製品との間に提携関係はありません。
国ID `ht` でハイチOTP APIを呼び出す
開発者は、同じ在庫にREST経由でアクセスできます。Developerコンソールで作成したBearerキー（接頭辞 or_live_）で https://otproute.com/api/v1 に対して認証し、次の手順に進みます。
GET /api/v1/servicesでサービスを一覧し、対応状況を確認するにはGET /api/v1/countriesで国を一覧します。GET /api/v1/prices?country=ht&service=<id>でライブの価格を読み取ります。POST /api/v1/activationsに{"service": "<id>", "country": "ht"}を送って注文します。activation.sms_receivedのWebhook、またはGET /api/v1/activations/{id}のポーリングでコードを取得します。- テストが別の形で終わった場合は、
POST /api/v1/activations/{id}/cancelで番号を早めに解放します。
すべてのWebhookには X-OTPRoute-Signature: t=<unix>,v1=<hex> が付いています。エンドポイントのシークレットで、タイムスタンプと生のボディに対するHMAC-SHA256を検証し、タイムスタンプが古いイベントは破棄し、ハンドラーはアクティベーションIDで冪等にしてください。このOTPルーティングのフローは、API連携ガイドでさらに詳しく説明しています。スクリプトは、アカウントあたり1分300リクエストを目安に設計してください。
ダッシュボードから+509のコードを取得する
サポートや運用のスタッフは、APIをまったく使わずに済ませられます。ダッシュボードでOTP Gatewayを開き、ハイチとサービスを選んで、注文前に表示される価格を確認します。確定すると、テスト用の+509番号が発行されるので、アプリに貼り付けてSMSを要求し、注文カードにコードが表示されるのを待ちます。この番号は、その1回の認証のためのもので、20分のウィンドウが終了すると閉じられます。
コードがまだ届かない？ハイチのルートのトラブルシューティング
+509の注文で反応がないときは、よくある原因がいくつかあります。
- サービスがまだ送信中。 失敗と考える前に、ウィンドウの時間いっぱいまで待ちましょう。
- サービスが仮想番号を拒否している。 時間をおいた2回目の試行でも反応がない場合は、そのフローをテストする別の方法を選んでください。
- ルートが混み合っている。 新しい注文を立て続けに出すのではなく、少し待ってから再試行するか、同じサービスの別のルートを選んでください。
- Webhookがイベントを取りこぼした。 アクティベーションをポーリングして、すでにコードが届いていないか確認してください。
ウィンドウが何も届かないまま閉じた場合やキャンセルした場合は、全額が自動でウォレットに戻るため、失敗した試行にコストはかかりません。そのほかの対処法は、OTP配信失敗の削減にまとめています。
ハイチでの利用に向けた長期回線、ウォレット、サンドボックス
OTP Routeでは、セルフサービスの長期ハイチ番号は販売していません。更新している間は保持できるDedicated Virtual Numbersは、米国とカナダ向けの商品で、月額$1.95からです。北米側にあるディアスポラ向けのサポート回線の併用先としては、有力な選択肢になりえます。+509の長期回線がどうしても必要な場合は、[email protected] にメールしてください。チームで検討しますが、現地の規制次第であり、確約はできません。
支払いは1つのプリペイドUSDウォレットで行います。従量課金でサブスクリプションはなく、カードまたはUSDT/USDCでチャージでき、チャージのたびにPDFの請求書が届きます。開発用アカウントでサンドボックスモードを申請すれば、模擬のコードでSMS認証APIのフロー全体を事前にリハーサルできます。ハイチの番号は、自社のプロダクトと正当な業務アカウントのためにのみ使い、各サービスの規約を守り、利用規定（Acceptable Use Policy）の範囲内で利用してください。最初の注文を始める準備ができたら、サインアップしてください。
よくある質問
ハイチのSIMカードなしで、アプリのハイチ向けサインアップフローを確認できますか？
はい。OTP RouteのOTP Gatewayで+509番号を注文し、アプリのSMSを発行して、コードをダッシュボードまたはWebhookで読み取ります。
APIはハイチにどの国IDを使いますか？
IDは ht です。サービスIDと組み合わせて使います。たとえば、POST /api/v1/activations に {"service": "telegram", "country": "ht"} を送ります。
ハイチの認証番号で使えるサービスはいくつありますか？
最新のスナップショット時点で1,000を超えています。正確な一覧は一日の中で変わるため、注文前に GET /api/v1/prices かダッシュボードで確認してください。
+509のコードが届かなかった場合、支払いは発生しますか？
いいえ。SMSが届かないまま20分のウィンドウが過ぎた場合、またはその前にキャンセルした場合は、全額が自動でウォレットに戻ります。
コードはハイチ・クレオール語で届きますか？
送信するサービスとアカウントの言語次第です。メッセージがフランス語でも英語でもほかの言語でも数字を抽出できるように、テストを組んでください。
サポートデスク向けに、長期利用できるハイチの番号は取得できますか？
セルフサービスの商品としては提供していません。OTP Routeでは米国とカナダで専用回線を提供しています。ハイチについては、[email protected] にメールでご相談ください。
チャージにはどの支払い方法が使えますか？
カード、およびステーブルコインのUSDTまたはUSDCで、プリペイドのUSDウォレットにチャージされます。月額料金はなく、選ぶプランもありません。
サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。