キュラソー(+599)のSMSコードを受信するための事前チェックリスト

+599番号を注文する前のチェックリストには、何が必要ですか?

島の市場では、ルートの利用状況が日中に変わるため、少し準備しておくと報われ、慌てたテストは時間を無駄にします。最初のリクエストの前に、次の項目を確認してください。

• 開発者コンソールのAPIキー。キーはor_live_で始まり、1アカウントに最大10個まで保持できるので、CIとステージングには専用のキーを割り当ててください。
• 資金のあるUSDウォレット。または、連携の動作確認だけを行う場合は、ご依頼に応じてサンドボックスに切り替えた開発用アカウント。
• 正しいID。APIでのキュラソーはcwで、サービスIDはGET /api/v1/servicesから取得します。
• シークレットを保管したWebhookエンドポイント、または適切な間隔のポーリングループ。1アカウントにつき最大5つのエンドポイントを使えます。
• +599番号の保存ルール(後述)。テストデータを本番データと一致させるためです。
• 空振りの場合の計画:コードが届かないままウィンドウが期限切れになったとき、テストがどう動くか。

キュラソー認証番号のルートは、どのサービスをカバーしていますか?

キュラソーのライブスナップショットには、400を超えるサービスが掲載されています。人気のあるものには、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、ChatGPT (OpenAI)、Microsoft & Outlook、Amazon、Discord、LinkedIn、Signal、Netflix、Uber、Airbnbなどがあります。島のデジタル登録の多くはホスピタリティや旅行者向けのプロダクトが占めるため、キュラソーのチームがまず手に取るのは、旅行系とメッセージング系の名前です。

この一覧は約束ではなく、出発点として扱ってください。在庫は1日を通して変動するため、APIは料金を照会するたびに利用可否も返すようになっています。

ステップ別:キュラソーOTP APIの呼び出し

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

1. GET /api/v1/prices?country=cw&service=<id>を読み取り、ルートが開いていることと、その組み合わせの現在の価格を確認します。
2. POST /api/v1/activationsで注文を作成し、{"service": "telegram", "country": "cw"}、または必要なサービスIDを送信します。レスポンスにはアクティベーションIDと+599番号が含まれます。
3. その番号を、テストする登録画面またはログイン画面に入力します。
4. Webhookでactivation.sms_receivedを待つか、落ち着いた間隔でGET /api/v1/activations/{id}をポーリングします。
5. テストを中止する場合はPOST /api/v1/activations/{id}/cancelを呼び出し、ウォレットにすぐ返金されるようにします。

Webhookを信頼する前に、X-OTPRoute-Signatureヘッダーを確認してください。エンドポイントのシークレットで"<t>.<raw body>"のHMAC-SHA256を計算し、古いタイムスタンプは拒否します。詳しくはWebhook署名ガイドで解説しています。

+599番号はどのように保存し、正規化すべきですか?

キュラソーは、ボネール、シント・ユースタティウス、サバと国番号+599を共有しており、キュラソーの加入者番号はその国番号の後に9が続きます。この先頭の9はトランクプレフィックスではなく番号の一部なので、取り除く正規化処理はレコードを壊してしまいます。完全なE.164文字列(+5999に残りの桁を続けたもの)をスペースなしで保存し、フォーマットは表示するときにだけ加えてください。

また、電話番号の入力ウィジェットが、古いライブラリのように汎用のオランダ領アンティルという選択肢にまとめてしまわず、キュラソーを独立した項目として一覧表示しているかも確認する価値があります。

言語については、パピアメント語、オランダ語、英語がすべて公用語で、グローバルサービスの多くは英語か、アカウントに設定された言語でコードを送ります。プロダクトをオランダ語やパピアメント語にローカライズしている場合は、フォールバックではなく実際のテンプレートが見えるよう、言語ごとに少なくとも1回は確認してください。チームがここでテストを行うのは、オランダ領カリブ地域でのローンチ、海外から予約する旅行者への対応、島からの地域運用などの場合が一般的です。

コードを書かない人向けのダッシュボードでの手順は?

サポート担当者やプロダクトマネージャーは、スクリプトなしで同じことができます。

1. メールアドレスと6桁のコード、またはGoogleサインインでアカウントを作成し、TOTP二要素認証を有効にします。
2. ウォレットにチャージします。
3. OTP Gatewayを開き、サービスを選んでから、キュラソーを選びます。確定前に価格が表示されます。
4. +599番号をアプリにコピーし、コードが表示されるまでアクティベーションカードを見守ります。

APIと同じ20分のウィンドウと返金ルールが適用されます。

トラブルシューティング:キュラソーのコードが届かなかった

反応のないアクティベーションはときどき起こりますが、ウィンドウが閉じたときやキャンセルしたときに金額がウォレットに戻るため、費用はかかりません。

• ウィンドウの終わりまで待つ。再送が遅いサービスもあり、2分でキャンセルすると、これから届くかもしれないコードを捨ててしまいます。
• 対象サービスの仮想番号に対する方針を確認する。拒否するものもあり、そのために返金があります。
• 時間を置いて再試行するか、別の国のルートを試す。テストが特にキュラソーの番号に依存しないなら有効です。
• 短い間隔で再注文しない。1つのテストに対して並列のアクティベーションを積み重ねないよう、試行の間隔を空けてください。

自動化スイートにこうした再試行を組み込む方法は、QAテストのソリューションページで紹介しています。

キュラソーのプロジェクトにおける長期回線、ウォレット、課金

キュラソー向けのセルフサービスの長期番号はありません。数か月保持する回線が必要な場合は、[email protected]にメールしてください。チームが現地の規制で何が許されるかを確認しますが、提供はお約束できません。専用回線はアメリカとカナダ向けの製品で、月額$1.95からです。詳しくは仮想番号のページをご覧ください。

キュラソーのアクティベーションは、月額料金もプランの選択もない、前払いのUSDウォレット1つから引き落とされます。チャージはカード、またはUSDT/USDCのどちらでも行え、チャージのたびに、キュラソーのプロジェクトの帳簿用にPDF請求書がメールで届きます。最新の料金は料金ページにあります。OTP Routeは自社のプロダクトと正当なアカウントにのみ使い、各サービスの利用規約を守ってください。また、OTP Routeの利用規定(Acceptable Use Policy)が適用されることにもご注意ください。

よくある質問

現地のSIMを購入せずに、キュラソーの登録フローをテストできますか?

はい。テストするサービス用の+599番号をOTP Gatewayで注文し、ダッシュボードまたはAPIでコードを読み取ります。島にSIMや端末は不要です。

OTP Routeでのキュラソーの国IDは何ですか?

キュラソーはcwです。すべての料金確認と注文で、GET /api/v1/servicesが一覧するサービスIDと組み合わせてcwを指定します。

+599の後の9は、取り除くべきトランクプレフィックスですか?

いいえ。キュラソーでは9が加入者番号の一部なので、保存するE.164の値にも残してください。

キュラソーのアクティベーションがコードなしで期限切れになった場合、課金されますか?

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

来月の繰り返しのログイン用に、キュラソーの番号を保持できますか?

セルフサービスではできません。長期のDedicated Numbersはアメリカとカナダのみで販売しており、キュラソーについてはサポートにメールでお問い合わせいただけますが、提供をお約束するものではありません。

ウォレットの資金を使う前に、連携を構築するには?

サポートを通じて、開発用アカウントにサンドボックスモードを依頼してください。シミュレートされた番号とコードが返されるため、APIとWebhookの経路全体をエンドツーエンドで実行できます。

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