ジャマイカのSMS認証コード:チェックリスト、手順、対処法

最初のジャマイカ向けアクティベーションの前に何を確認すべき?

ジャマイカは北米番号計画(NANP)に含まれるため、ほとんどの国とは確認事項が少し異なります。

• バリデーターが、米国・カナダ以外の+1番号を受け付けること。 多くのサインアップフォームは、すべての+1番号がアメリカのものだと暗黙に想定しています。
• 国の選択肢にジャマイカが個別に表示されること。 +1を単一の地域として扱わないでください。
• Developerコンソールに or_live_ のAPIキーがあり、シークレット付きのWebhookエンドポイントがデプロイ済みであるか、テストハーネスがポーリングに設定されていること。
• ウォレットにチャージ済みであること、またはドライラン用にサンドボックスモードが有効になっていること。
• GET /api/v1/services から取得したサービスIDを把握していること。ジャマイカの国IDは jm です。

最初の2点を誤ると、ルーティングの問題のように見えて、実際にはすべて自社コード内にある不具合が発生します。

+1のジャマイカ番号に特別な処理が必要なのはなぜ?

ジャマイカの番号は市外局番876と、より新しい658を使い、その後に7桁の加入者番号が続くため、完全なE.164形式は +1 に10桁を足したものです。国内では長距離通話のために先頭に1をダイヤルしますが、保存前に取り除く必要があります。

エンジニアにとって重要なのは、+1 だけでは国が分からないという点です。地域の判定は市外局番を見る必要があり、ダイヤルコードから通貨、タイムゾーン、SMSテンプレートを決めるロジックも同じ注意が必要です。正規のE.164文字列を保存し、判定した地域は別のフィールドに持たせ、876と658の両方の入力をテストしてください。

公用語は英語で、認証SMSはほぼ必ず英語で届きますが、日常会話ではジャマイカ・パトワ語がよく使われます。このルートでテストするのは、カリブ海地域へのローンチ、米国・英国・カナダにいるディアスポラ向けの送金・フィンテックのフロー、観光・ホスピタリティ系のプロダクトなどです。市場ごとのルートの選び方はOTPの国別ルーティングの記事で解説しています。

ジャマイカのSMS認証APIの手順は?

1. ベースURL https://otproute.com/api/v1 に対して、GET /api/v1/prices?country=jm&service=<id> でリアルタイムの価格を確認します。
2. 注文:{"service": "<id>", "country": "jm"} を本文にして POST /api/v1/activations を送ります。アクティベーションIDと番号を控えます。
3. テスト中のアプリに番号を入力します。
4. コードは、Webhookの activation.sms_received イベントか、GET /api/v1/activations/{id} のポーリングで受け取ります。
5. ジャマイカでの試行を早めに打ち切るには、POST /api/v1/activations/{id}/cancel を送ると、保留が解除されます。

イベントを処理する前に、エンドポイントのシークレットで "<t>.<raw body>" のHMAC-SHA256を再計算し、X-OTPRoute-Signature の v1 の値と比較し、古すぎるタイムスタンプは拒否してください。activation.expired と activation.cancelled もアクティベーションIDをキーに処理し、再試行で二重処理が起きないようにします。容量計画としては、1アカウントでキー10個とWebhookエンドポイント5つを持て、全体で毎分300リクエストが上限です。

ジャマイカのルートでコードを受信できるアプリは?

ジャマイカでは現在、900を超えるサービスが一覧にあります。よく使われるものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、Snapchat、Amazon、Uber、Netflix、Airbnb、ChatGPT (OpenAI)があります。

サービスごとの利用可否は一日の中で変動するため、一覧をハードコードせず、実行のたびに最初に価格エンドポイントを読み取ってください。

開発者でない人は、ダッシュボードで同じチェックリストをどう進める?

/signup でメールコードまたはGoogleでアカウントを作成し、TOTPを有効にして、チャージします。続いてOTP Gatewayを開き、サービスとジャマイカを選び、リアルタイムの価格を確認します。番号をアプリに貼り付けると、テキストが届いた時点でコードがダッシュボードに表示されます。サポート担当者は、この方法でジャマイカの番号でのお客様のサインアップ問題を再現することがよくあります。

トラブルシューティング:ジャマイカのコードが遅い、届かない、拒否された

• 入力の時点で拒否された? まず自社のフォームを確認してください。米国専用のバリデーターがよくある原因です。サードパーティのアプリ自体が番号を拒否する場合は、仮想番号を受け付けていない可能性があります。
• まだ何も届かない? キャンセルして再注文するのではなく、アクティベーションを20分間開いたままにしてください。
• それでも届かない? 時間をおくか、別のサービスルートで再試行してください。同じ注文をループで連打するのは避けます。

ウィンドウが終わるまでにSMSが番号に届かなかった場合は、全額が自動的にウォレットに返金されます。より詳しいチェックリストはOTP配信失敗を減らすにはにあります。

専用回線、ウォレット、サンドボックスはジャマイカにも適用される?

+1の国番号を共有していても、ジャマイカが専用番号の対象になるわけではありません。Dedicated Virtual Numbersは米国とカナダのみで、月額$1.95からです。セルフサービスのジャマイカの長期番号はありません。必要な場合は [email protected] にメールで問い合わせてください。現地の規制次第で、確約はできません。

それ以外は他の国と同じです。前払いのUSDウォレット、月額料金なし、チャージはカードまたはUSDT/USDC、そして毎回PDFの請求書がメールで届きます。リクエストに応じて提供されるサンドボックスモードでは、インテグレーションテスト用に模擬の番号とコードが返されます。課金の仕組みは /pricing をご覧ください。

よくある質問

キングストンにいなくても、ジャマイカの電話認証をテストできる?

はい。OTP Routeでご利用のサービス向けに+1 876または+1 658の番号を注文し、チームの拠点がどこにあっても、コードをダッシュボードまたはAPIで読み取れます。

ジャマイカにはどの国IDを送る?

jm を送ります。ダイヤルコードは+1ですが、APIはこのIDで国を識別します。

ジャマイカの番号は米国の番号として扱われる?

いいえ。+1の国番号は共有していますが、独自の市外局番を持つ別の国で、多くのアプリはジャマイカとして扱います。

ジャマイカのコードが来なかったら、お金はどうなる?

20分以内にSMSが届かなかった場合、またはキャンセルした場合は、全額がウォレットに戻ります。

OTP Routeでジャマイカの長期番号を購入できる?

セルフサービスではできません。長期のDedicated Numbersは米国とカナダのみが対象で、ジャマイカについてはサポートにメールでお問い合わせください。

料金をかけずにWebhookのフローをテストする方法は?

開発アカウントでサンドボックスモードを依頼してください。模擬の番号とコードが返されます。ハンドラー側については、Webhookによる認証コードの取得の記事で解説しています。

テスト目的で+1のジャマイカ番号を使うことは、どこまで認められる?

ご自身のプロダクトのテスト、QAの自動化、正当なビジネスアカウントの運用です。このカリブ海のルートは、各アプリの規約とOTP Routeの利用規定(Acceptable Use Policy)の両方に従います。

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