WebhookとポーリングでつくるガイアナOTP（+592）認証テスト

Webhook優先のガイアナOTP APIフローは、どう設計すればよいですか？

単発の確認を超える用途では、何度も問い合わせるのではなく、プラットフォーム側からコードをプッシュしてもらいましょう。Developerコンソールでhttpsのエンドポイントを追加（1アカウントにつき5つまで）し、activation.sms_received に加えて activation.expired と activation.cancelled も購読します。そうすれば、テストランナーは成功だけでなく、行き止まりもすぐに把握できます。

受信したリクエストはすべて、検証を通るまで信頼しないものとして扱ってください。

• t=<unix>,v1=<hex> 形式の X-OTPRoute-Signature ヘッダーを読み取ります。
• タイムスタンプ、ドット、加工していないリクエストボディを連結し、その文字列に対してエンドポイントのシークレットでHMAC-SHA256を計算します。
• 計算したダイジェストと v1 を定数時間で比較し、タイムスタンプが古い場合はリクエストを破棄します。
• イベントからアクティベーションIDを取り出し、すでに処理済みなら成功を返して、それ以上は何もしません。

最後のルールによってハンドラーが冪等になり、ネットワークの不調後に再配信されても、テストが混乱することはありません。詳しい解説はWebhookによるOTP取得にあります。

+592の注文には、どのエンドポイントとIDを使いますか？

Developerコンソールで作成したBearerキーで認証します。ライブキーは or_live_ で始まり、1アカウントにつき最大10個まで保持できます。ベースURLは https://otproute.com/api/v1、ガイアナの国IDは gy です。

典型的な実行では、まず GET /api/v1/prices?country=gy&service=<id> を読み取ります。このルートの価格と可用性は固定値ではなくリアルタイムの値だからです。次に POST /api/v1/activations に {"service": "<id>", "country": "gy"} を送ると、+592番号とアクティベーションIDが返ります。Webhookを使わない場合、ランナーは数秒おきに GET /api/v1/activations/{id} をポーリングしますが、これは1分あたり300リクエストの上限をはるかに下回ります。テストが中断したときは、後処理のステップで POST /api/v1/activations/{id}/cancel を呼び出し、事前チェックとして GET /api/v1/balance を呼べば、ウォレットの残高が少ないときにスイートを早めに止められます。サービスIDは GET /api/v1/services で取得します。このSMS認証APIのクライアント例は、開発者向けページにあります。

+592番号は、保存時にどう整形しますか？

ガイアナの国コードは592で、国内番号は7桁、取り除くべきトランクプレフィックスはありません。そのため、E.164形式は +592 に続けてその7桁を付けるだけです。数字は通常、3桁と4桁のグループに分けて書かれます。

取り除く先頭のゼロがないので、正規化は、スペースとハイフンを削除し、ユーザーが市内の数字だけを入力した場合に国コードを付けることに尽きます。よくあるバグは、南米のすべての番号に市外局番があると決めつけたり、最小桁数を7桁より大きく設定したりして、有効なガイアナの番号を弾いてしまうフォームです。+592のテスト用番号があれば、こうした問題をすぐに見つけられます。保存するのはE.164の文字列にして、ローカルの表記は表示時にだけ適用してください。

ガイアナのSMS OTPコードを受信できるサービスは何ですか？手動で注文することもできますか？

ガイアナのルートでは、900を超えるサービスが利用できます。よくリクエストされるものには、WhatsApp、Facebook、Instagram、Google（Gmail & YouTube）、TikTok、Telegram、imo、Viber、Snapchat、Amazon、Microsoft & Outlook、Discord、Netflix、Claudeなどがあります。この一覧はライブのカタログのスナップショットなので、特定の送信元を前提にテストを組む前に、APIかダッシュボードで確認してください。

コードを書かない同僚には、ダッシュボードが同じ役割を果たします。サインインしてOTP Gatewayを開き、ガイアナとサービスを選んで価格を確認し、注文します。ガイアナの認証番号が20分のカウントダウンとともに表示され、コードが届くとその隣に表示されます。

+592のコードが遅れたり届かなかったりしたとき、テストはどう動くべきですか？

アクティベーションは20分間有効です。支払いが発生するのは、この時間内にコードが届いたときだけで、期限切れやキャンセルの場合は、サポートへの問い合わせなしで全額がウォレットに戻ります。

自動実行での適切な処理は次のとおりです。

1. テストに厳格な制限時間がない限り、失敗と判断する前にウィンドウが終わるまで待ちます。制限時間がある場合は、明示的にキャンセルします。
2. 時間をおいて再試行するか、APIが別のサービスルートを提示するなら、そちらに切り替えます。
3. 対象のサービスが仮想番号を受け付けているか確認します。拒否するサービスもあり、返金はまさにそのケースをカバーします。
4. 再試行は、タイトなループで再注文せず、バックオフを入れて間隔を空けます。

代替ルートの選び方は、OTPの国別ルーティングのガイドで解説しています。

なぜチームはガイアナのサインアップフローをテストするのですか？

ガイアナは南米で唯一、英語を公用語とする国で、ジョージタウンにはカリブ共同体（CARICOM）の事務局があります。そのため、カリブ共同体を1つの市場として扱う展開に登場することがよくあります。急成長する海洋エネルギー分野には海外の請負業者やサプライヤーが集まり、米国、カナダ、英国にいる大規模なディアスポラによって、送金、メッセージング、旅行のアプリが+592番号で活発に使われています。日常的にはガイアナ・クレオール語が広く話されていますが、認証SMSは通常、英語で届きます。QAでは、翻訳された文言よりも、番号入力、国の選択UI、SMS同意の文言に重点を置くことになります。すべての確認は、自社の組織が所有するアカウントで行い、各サービスの規約に従ってください。OTP Routeの利用規定（Acceptable Use Policy）は、すべての注文に適用されます。

ガイアナの回線を保持できますか？利用料金はどのように請求されますか？

ガイアナ向けのセルフサービスの長期番号は提供していません。OTP RouteのDedicated Numbersは米国とカナダのみで、月額$1.95からです。+592の回線が必要な場合は、[email protected] にメールしてください。チームが現地の規制で何ができるかを確認しますが、確約はできません。

支払いは1つのプリペイドUSDウォレットで行います。月額料金やプランはなく、カードまたはUSDT/USDCでチャージでき、チャージのたびにPDFの請求書がメールで届きます。リクエストに応じて、開発用アカウントをサンドボックスに切り替えられるため、連携テストは模擬の番号とコードで実行でき、残高には影響しません。サービスごとの料金は料金ページに掲載しています。

よくある質問

ガイアナの通信事業者のSIMなしで、アプリのガイアナ向けサインアップを確認できますか？

はい。OTP Gatewayで対象サービス用の+592番号を注文し、フローに入力すれば、コードがダッシュボードに表示されるか、Webhookに届きます。料金は1コード $0.20 からです。

APIはガイアナにどの国IDを使いますか？

gy です。価格取得クエリとアクティベーションのリクエストボディの両方で使います。

ガイアナの番号の先頭のゼロは取り除く必要がありますか？

いいえ。ガイアナにはトランクプレフィックスがないため、E.164形式は +592 に7桁の番号を続けた形になります。

+592の認証メッセージは何語で届きますか？

通常は公用語である英語です。ただし、文面は送信元が決めるため、アプリの言語設定に合わせる場合もあります。

サービスがSMSを送ってこなかった場合、返金はありますか？

はい、自動で行われます。コードが届かないまま20分が経過した場合、またはキャンセルした場合は、全額がウォレットに戻ります。

お金をかけずに連携全体をテストできますか？

サポートに依頼して、開発用アカウントをサンドボックスに切り替えてください。模擬の番号とコードが返されるため、APIコールとWebhookをエンドツーエンドで試せます。

長期利用できる+592番号はありますか？

セルフサービスの商品としては提供していません。Dedicated Numbersは米国とカナダでのみ販売しています。ガイアナについては、[email protected] にメールでお問い合わせください。

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