ケイマン諸島の認証番号のための事前チェックリスト

事前チェックリスト:+1 345番号を注文する前に、何を準備しておくべきですか?

このリストを一度確認しておけば、最初のケイマンのアクティベーションは、たいてい何事もなく終わります。

• アカウントとセキュリティ。 メールアドレスと6桁のメールコード(またはGoogleサインイン)でサインアップし、ウォレットから支払える人には、TOTPの二要素認証を有効にします。
• ウォレットのチャージ。 前払い制のUSDウォレットに、カードまたはUSDT/USDCで入金します。選ぶべきプランも月額料金もありません。
• APIキー。 開発者コンソールでキーを作成します。キーは or_live_ で始まり、Bearerヘッダーに入れて送ります。1アカウントで最大10個のキーを保持できます。
• Webhookエンドポイント。 URLを登録し、そのシークレットをハンドラーが読める場所に保管します。上限は1アカウントあたり5エンドポイントです。
• 電話番号のパース設定。 番号ライブラリが、すべての +1 番号を米国にフォールバックさせるのではなく、市外局番345をケイマン諸島に解決することを確認します。
• 予行演習をしたい場合のサンドボックス。 サポートに依頼して開発用アカウントをサンドボックスモードに切り替えると、シミュレートされた番号とコードで、ウォレットの資金に触れずに連携を試せます。

レスポンスに含まれるすべてのフィールドは、APIリファレンスに載っています。

+1を米国だと決め込むコードが、ケイマンの番号でつまずくのはなぜですか?

ケイマン諸島は北米番号計画(NANP)に含まれ、国番号1を米国、カナダ、そして数多くのカリブ海地域と共有しています。ケイマンの回線を識別するのは、市外局番345です。完全な番号は国番号の後ろに10桁が続き、国内では (345) NXX-XXXX と書かれ、E.164形式では +1345 に7桁を続けた形で保存されます。

エンジニアにとっての実務上の帰結は3つあります。

• 地域の判定は、市外局番を見て行う必要があります。+1 のプレフィックスだけから国を推定するサインアップフォームは、ケイマンの顧客を米国人として扱い、タイムゾーン、通貨、同意文言を誤って選ぶ可能性があります。
• NANPでは、先頭の1が長距離のトランク桁を兼ねるため、ユーザーが 1 345... や 345... と入力することがあります。保存する前に、3通りすべてをE.164の文字列に正規化してください。
• 番号は、スペース、ハイフン、括弧なしで保存し、書式は表示時にだけ整えます。

公用語は英語なので、この市場向けのコードは通常、英語で届きます。ただし、正確な文言を決めるのはルートではなく、メッセージを送るサービスです。

ケイマン諸島の認証番号にコードをルーティングできるサービスは?

国 ky のライブスナップショットには現在、WhatsApp、Telegram、Google (Gmail & YouTube)、Microsoft & Outlook、LinkedIn、Amazon、Airbnb、Uber、Signal、Discord、ChatGPT (OpenAI)、Netflix、eBayなどが含まれています。ロングテールまで数えると、このルートは600を超えるサービスに対応しており、一覧は一日の中で変わります。利用可否を決め打ちにせず、常にAPIから読み取るのはそのためです。

チームが+1 345番号をテストに必要とするのは、この島々が主要なオフショア金融センターであり、賑わう観光地でもあるからです。ファンド管理会社、保険会社、旅行プラットフォーム、不動産事業者が現地の顧客をオンボーディングしており、そのプロダクトチームは、ケイマンの居住者が体験するとおりにサインアップフローが動くかを確認したいと考えます。このパターンは、フィンテックのオンボーディングのノートでさらに詳しく扱っています。

ステップごとに:ケイマン諸島のOTP APIは、どの順番で呼び出しますか?

すべての呼び出しは、Bearerキーを付けて https://otproute.com/api/v1 に送ります。上限は毎分300リクエストです。

1. GET /api/v1/services を一度呼び、テストスイートで必要なサービスIDをキャッシュします。
2. GET /api/v1/prices?country=ky&service=<id> を呼び、現在の価格を確認し、その組み合わせがいま利用可能であることを確かめます。
3. {"service": "<id>", "country": "ky"} のようなボディを付けて POST /api/v1/activations を送ります。レスポンスには、アクティベーションIDと+1 345番号が含まれます。
4. その番号を、テスト対象のアプリに入力し、SMSのステップを発生させます。
5. Webhookで activation.sms_received を待ちます。まず X-OTPRoute-Signature ヘッダーを確認します。エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算して v1 と比較し、古いタイムスタンプは拒否してください。
6. Webhookがない場合は、コードが表示されるかウィンドウが閉じるまで、控えめな間隔で GET /api/v1/activations/{id} をポーリングします。
7. テストを中断する場合は、POST /api/v1/activations/{id}/cancel を呼び、保留分をウォレットに戻します。

署名の検証は、HMAC Webhookガイドで1行ずつ解説しています。

ダッシュボードを使いたい同僚のための、ステップごとの手順

サポート担当やアカウントマネージャーは、APIに触れる必要はまったくありません。

1. ダッシュボードで、OTP Gatewayのページを開きます。
2. 国としてケイマン諸島を選び、続けて認証したいサービスを選びます。
3. 注文する前に表示された価格を確認して、確定します。
4. 番号をアプリにコピーしてコードを要求し、アクティベーションのページを開いたままにしておきます。SMSが届くと、そこに表示されます。

20分のウィンドウと返金は、API経由の場合とまったく同じように適用されます。

トラブルシューティング:+1 345番号にコードが届かないときは?

何も届かなかったアクティベーションには、課金されません。20分が尽きるまでにSMSが届かなかった場合や、キャンセルした場合は、全額が自動的にウォレットへ戻ります。再注文する前に、次の点を確認してください。

• ウィンドウが終わるまで待つ。 配信にかかる時間はサービスとルートによって決まるため、遅いコードが必ずしも失敗とは限りません。
• サービスのポリシーを確認する。 仮想番号を完全に拒否するサービスもあり、返金はまさにそのような状況のためにあります。
• 時間をおいて再試行するか、ルートを切り替える。 在庫は一日の中で変わります。1時間後にやり直したり、近隣のカリブ海の国を使ったりすると、挙動が変わることがあります。
• 短い間隔での繰り返しを避ける。 数秒おきにキャンセルと再注文を繰り返すスクリプトは、レート制限を消費するだけで、ほとんど効果がありません。

さらなる診断方法は、配信失敗への対処ガイドにあります。番号は、自社のプロダクトまたは自社の業務用アカウントにのみ使用し、すべてのサービスの規約を守ってください。OTP Routeの利用規定(Acceptable Use Policy)も適用されます。

ケイマンの回線を長期間保持できますか?課金の仕組みは?

ケイマン諸島には、セルフサービスで使える長期利用の番号はありません。+1 の国番号を共有していても、それは変わりません。Dedicated Numbersは米国とカナダ専用のプロダクトで、月額$1.95/monthからです。SMS受信、SMS送信、ブラウザ通話に対応しています。恒常的な345の回線が必要な場合は、[email protected] にメールしてください。提供できるかどうかは現地の規制次第で、お約束はできません。

それ以外はすべて、前払い制のUSDウォレット1つで動きます。カードまたはUSDT/USDCでチャージするたびに、PDFの請求書がメールで届きます。従量課金の仕組みは、料金ページで説明しています。

よくある質問

現地のSIMなしで、アプリのケイマン諸島向けサインアップフローをテストできますか?

はい。OTP Gatewayで+1 345番号を注文してアプリに入力し、ダッシュボードまたはAPIでコードを読み取ります。料金は1コード$0.20 からで、コードが届いた場合にのみ課金されます。

APIでは、ケイマン諸島の国IDは何を使いますか?

IDは ky です。GET /api/v1/prices や POST /api/v1/activations を呼ぶときに、country の値として渡します。

ケイマンの電話番号は、データベースにどう保存すべきですか?

E.164形式で保存します。+1345 に7桁の加入者番号を続けた形で、スペースや記号は入れません。地域は +1 のプレフィックスではなく、345の市外局番から判定してください。

+1 345番号は、Dedicated Numbersでは米国の番号として扱われますか?

いいえ。Dedicated Numbersは米国とカナダにのみ販売されているため、ケイマンの回線は、コード1回分のOTP Gatewayのアクティベーションとしてのみ利用できます。

SMSが届かなかった場合、お金はどうなりますか?

アクティベーションは20分間開いたままです。その間にコードが届かなかった場合や、先にキャンセルした場合は、全額が自動的にウォレットへ返金されます。

ウォレットの資金を使わずに、CIでケイマンのOTPテストを実行できますか?

サポートに依頼して、開発用アカウントをサンドボックスに切り替えてください。シミュレートされた番号とコードが返るため、パイプラインでアクティベーションとWebhookの全フローを、費用をかけずに試せます。

OTP Routeは、ケイマンのサービスをいくつカバーしていますか?

直近のスナップショット時点で600を超えます。在庫は一日の中で変わるため、最新の利用可否は GET /api/v1/services と価格エンドポイントで確認してください。

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