QAとローンチ作業向け:タークス・カイコス諸島(+1 649)の認証コード

+1 649の番号は、なぜアメリカの番号と同じではないのですか?

カリブ海のイギリス海外領土であるタークス・カイコス諸島は、北米番号計画(NANP)に属しています。番号の国番号はアメリカやカナダと同じ+1で、市外局番は649です。そのため完全な番号は +1 649 に7桁を続けた形で、+1の後ろは合計10桁になります。

この共通の国番号こそ、多くのサインアップフォームが誤りやすい点です。

• 国の判定。 +1をそのままアメリカに対応づけるコードは、これらのユーザーを誤判定し、誤った地域ルールを適用し、国選択に誤った国旗を表示することもあります。リージョンは+1だけでなく、市外局番から判定してください。
• 保存。 E.164形式の +1649XXXXXXX で保存します。NANP内の国内ダイヤルでは先頭に1を付けることがありますが、それは表示とダイヤルのためのもので、保存値には含めません。
• 文面。 公用語は英語なので、多くのサービスはこれらの番号に英語でコードを送ります。そのため解析は簡単です。

実際の+1 649番号を使うことが、検証ライブラリや国のロジックが諸島を独立した地域として扱えているかを確かめる最も直接的な方法です。

プロダクトチームが、テストのために+1 649の番号を必要とするのはなぜですか?

この島々の経済は観光が支えているため、旅行、予約、ホスピタリティ系のアプリが代表的な対象です。プロビデンシャレスの不動産管理者やツアー運営者が現地の番号で登録することがあり、フローはそれを受け付けなければなりません。決済やフィンテックのチームは別の理由で重視します。アメリカ国外の+1番号は、見落としやすい別個のオンボーディングルールを引き起こすことがあるためです。

また、グローバルなプロダクトにとって小さくまとまったエッジケースにもなります。+1 649でサインアップが動けば、ほかのカリブ海のNANP市外局番も正しく扱えているという良い目安になります。このようなテスト対象の市場の選び方は、OTPの国別ルーティングの記事で解説しています。

タークス・カイコスの認証用番号に、どのサービスがコードを送れますか?

現在のスナップショットでは、諸島向けに800を超えるサービスが利用可能です。人気のものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、X (Twitter)、Airbnb、Uber、Amazon、eBay、Netflix、Microsoft & Outlook、Discordがあります。

小さな地域では在庫が薄く、変動も大きくなりがちです。注文する直前に利用可否を問い合わせ、+1 649番号が必須ではないテストのために、代替ルートも用意しておいてください。

タークス・カイコスのOTP APIの呼び出し手順はどうなりますか?

すべての呼び出しは、Developerコンソールで作成した or_live_ で始まるBearerキー(1アカウントにつき最大10個)を付けて、https://otproute.com/api/v1 に送ります。この島々の国idは tc です。

1. GET /api/v1/prices?country=tc&service=<id> は、これからテストするサービスのライブ料金と利用可否を返します。
2. POST /api/v1/activations に {"service": "airbnb", "country": "tc"} を送ると、注文が作成され、アクティベーションidと番号が返ります。
3. 番号をアプリに入力し、GET /api/v1/activations/{id} またはWebhookからコードを読み取ります。
4. POST /api/v1/activations/{id}/cancel は、テストで不要になった注文を解放し、GET /api/v1/balance は、パイプラインが実行分の費用をまかなえるかを教えてくれます。

Webhookでは、最大5つのエンドポイントを登録し、activation.sms_received、activation.expired、activation.cancelled を受け取ります。X-OTPRoute-Signature ヘッダー(t=<unix>,v1=<hex>)は、エンドポイントのシークレットで <t>.<raw body> に対してHMAC-SHA256を計算して検証し、古いタイムスタンプは拒否し、アクティベーションidで重複を排除してください。1分あたり300リクエストの上限は、アカウント全体で共有されます。すべてのフィールドはAPIリファレンスに載っています。

ダッシュボードから+1 649の番号を取得するにはどうしますか?

コードを書くよりクリックで済ませたい場合は、メールと6桁のコードまたはGoogleでアカウントを開設し、チャージしてからOTP Gatewayに進みます。タークス・カイコス諸島とサービスを選び、画面上の料金を確認して決定します。番号をアプリにコピーすると、コードが届いたときに同じアクティベーションのページに表示されます。

+1 649の番号にコードが届かないときはどうすればよいですか?

注文から20分間の猶予があります。SMSが届かないままウィンドウが切れた場合、または早めにキャンセルした場合は、全額がウォレットに自動で返金されるため、失敗した試行に費用はかかりません。

何度も起きる場合は、次を試してください。

• ウィンドウをフルに待ちます。タイミングはサービスやルートによって異なります。
• サービスが仮想番号を受け付けるか確認します。仕様上拒否するものもあります。
• 時間をおいて再試行するか、テストに諸島が必須でなければ別のルートに切り替えます。
• 新しい注文を連続して送らないでください。間隔をあけ、アクティベーションidごとにログを残します。

不安定な実行については、配信失敗チェックリストにさらにヒントがあります。

専用の+1 649回線は取得できますか?また、請求はどうなりますか?

いいえ。諸島は北米と+1を共有していますが、専用回線の提供はアメリカとカナダのみで月額$1.95からであり、タークス・カイコスの番号は対象外です。長期の+1 649回線をご希望の場合は [email protected] までご連絡ください。実現できるかは現地の規則によるため、難しい場合もあります。

すべての料金は、月額費用のないプリペイドのUSDウォレットから課金されます。カードまたはUSDT/USDCでチャージでき、チャージのたびにPDFの請求書がメールで届きます。開発中はサンドボックスモードを依頼でき、模擬の番号とコードが返されるため、SMS認証APIの連携をエンドツーエンドで無料でテストできます。

よくある質問

現地のSIMなしで、アプリのタークス・カイコス向けサインアップを検証できますか?

はい。OTP Gatewayで+1 649の番号を注文し、サインアップフォームで使って、ダッシュボードまたはAPIでコードを読み取ります。

タークス・カイコス諸島には、どの国idを送ればよいですか?

料金エンドポイントと POST /api/v1/activations のボディに、tc を送ってください。

OTP Routeは+1 649をアメリカの番号として扱いますか?

いいえ。国番号+1は共通ですが、APIでは独自のid、サービス、料金を持つ別の国として扱われます。

タークス・カイコスの認証用番号はいくらですか?

料金は$0.20/コードからで、正確な金額はサービスによって異なり、注文を確定する前に表示されます。

アメリカやカナダの専用番号を、+1 649のテストの代わりにできますか?

テストが地域を問わない場合のみ可能です。アメリカやカナダの回線では、諸島の市外局番やそれに結びついたルールを検証できません。

同じ+1 649の番号を、後のログインで再利用できますか?

通常はできません。OTP Gatewayの各番号は1回分のコードを受け取るためのもので、再度サインインが必要なアカウントには別のプランが必要です。

禁止されている使い方は何ですか?

権利のないアカウントの作成や、サービスの規約に反する行為です。OTP Routeは、ご自身の正当なプロダクトのテストと運用のためのもので、利用規定(Acceptable Use Policy)が適用されます。

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