ハンガリー（+36）の電話認証をテストする：チェックリスト、手順、対処法

ハンガリーOTP APIの実行に向けて、スタックの準備はできていますか？チェックリスト

このリストは、テストごとではなく、プロジェクトごとに1回確認してください。

1. アカウントのセキュリティ。 サインアップしたら、キーを生成する前にTOTPの二要素認証を有効にします。
2. 環境ごとのキー。 Developerコンソールで or_live_ キーを、パイプラインや開発者のマシンごとに1つずつ作成します。キーが漏えいしても、ほかの全員を止めずに無効化できます。
3. IDはコードではなく設定に。 ハンガリーは hu です。サービスIDは GET /api/v1/services から読み取り、対応表は設定ファイルに保存します。
4. Webhookの宛先。 httpsのエンドポイント（1アカウントにつき5つまで）を登録し、そのシークレットはシークレット管理ツールに保管します。
5. 予算ガード。 スイートの冒頭で GET /api/v1/balance を呼び、資金が足りないときは正常終了させます。
6. 地域を考慮したパース。 ハンガリー人は国内向けフォームで国コードをほとんど入力しないため、電話番号の入力欄が地域HUを認識するようにしてください。

テストフレームワークでこれを通常どう構成するかは、QAテストのソリューションページで紹介しています。

+36番号の処理に、専用のテストケースが必要なのはなぜですか？

ハンガリーの国コードは+36で、国内のトランクプレフィックスは 06 です。ハンガリーのユーザーは、携帯番号を06 30 123 4567や06 20 ...の形で入力することがよくあります。20、30、31、50、70は一般的な携帯のプレフィックスです。フォームは、06 を国コードの後ろに残すのではなく、取り除いて +3630... に変換する必要があります。次のケースは、明示的に書いておきましょう。

• 国内形式の入力欄での 06 30 ...
• +36 30 ... と 0036 30 ...（00 は国際アクセスプレフィックスのため）
• スペース、スラッシュ、ハイフン。実際の入力では、あらゆる組み合わせで現れます。

公用語はハンガリー語で、アカウントのロケールをハンガリー語にすると、コードをハンガリー語で送るサービスも多くあります。文字ő、űはGSM 7ビットアルファベットに含まれないため、これらを含むハンガリー語のメッセージはUCS-2でエンコードされ、1セグメントあたりの文字数が少なくなります。自社プロダクトがハンガリー語のコードを送る場合は重要な点であり、抽出した数字だけでなく、テストログの受信テキストも読んだほうがよい理由にもなります。ハンガリー語は単語も長くなりがちなので、ローカライズのQAでは、電話番号のステップとそのエラーメッセージが小さな画面でも収まるかを確認してください。

+36のテスト用番号で使えるハンガリーのルートは何ですか？

hu のOTPルーティングは、現在1,600を超えるサービスに対応しています。現在のスナップショットでよくリクエストされるルートは、WhatsApp、Viber、Facebook、Instagram、Google（Gmail & YouTube）、Uber、Airbnb、eBay、Amazon、LinkedIn、Netflix、ChatGPT（OpenAI）です。

これらのルートはスナップショットであり、在庫は一日を通して動くため、APIは価格のリクエストのたびに可用性も返します。古い回答をキャッシュせず、注文する直前に GET /api/v1/prices?country=hu&service=<id> を問い合わせてください。

手順：APIでハンガリーのSMS OTPコードを受信する

チェックリストが済んだら、SMS認証APIを通した1回のテストに必要なコールは多くても5つで、すべて https://otproute.com/api/v1 に対して行います。

1. GET /api/v1/prices?country=hu&service=uber でルートを確認し、価格を記録します。
2. POST /api/v1/activations に {"service": "uber", "country": "hu"} を送ります。アクティベーションIDは、以降すべての処理のキーになるので、控えておきます。
3. 返された+36番号を、アプリの認証画面に入力します。
4. コードを受信します。Webhookでは activation.sms_received が配信され、ポーリングでは GET /api/v1/activations/{id} を使います。2つの経路が競合しないよう、ジョブごとにどちらか一方を選んでください。
5. テストが失敗したら、POST /api/v1/activations/{id}/cancel で、すぐに資金を解放します。

Webhookは、信頼する前に必ず検証してください。X-OTPRoute-Signature を t と v1 に分割し、エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算し、定数時間で比較し、古すぎるタイムスタンプは拒否します。activation.expired と activation.cancelled は最終状態として扱い、リトライを止めます。実際の例はOTP API連携ガイドにあります。

APIに触れない同僚向けの手順

カスタマーサクセスやマーケティングのスタッフは、ダッシュボードを使えます。OTP Gatewayを開き、ハンガリーとサービスを選んで、表示された価格を確認して確定し、+36番号をアプリに貼り付けます。コードは注文自体に表示されます。20分以内に何も届かなければ、注文は期限切れになり、ウォレットには全額が返金されるので、失敗した試行にコストはかかりません。

ハンガリーの認証番号が無反応のときのトラブルシューティング

チケットを開く前に、次を順に確認してください。

• 番号はE.164で送信しましたか？ +36 の後ろに余分な 06 が残っているのは、自分で招く失敗として最もよくあります。
• サービスは仮想番号を受け付けていますか？ 受け付けないサービスもあります。自動返金がこのケースをカバーし、別のサービスルートや近隣の国に切り替えるのが、通常は最も早い解決策です。
• ウィンドウの終わりまで待ちましたか？ 短い待ち時間でキャンセルすると、届く途中だったコードを失うことがあります。注文はそのまま進めて、あとで再試行してください。
• スクリプトが1つのルートに連打していませんか？ 再試行はバックオフを入れて間隔を空けましょう。即時の再注文を繰り返してもほとんど効果がなく、プラットフォーム側の不正検知にかかる可能性もあります。

さらに詳しくは、OTP配信失敗の削減の記事をご覧ください。

ハンガリーでの長期回線、ウォレット、責任ある利用

ハンガリーには、セルフサービスの長期番号はありません。運用チームやサポートチームが必要な場合は、ユースケースを添えて [email protected] にご連絡ください。提供可否は現地の規制によるため、確約はできません。セルフサービスのDedicated Virtual Numbersは、米国とカナダの回線のみで、月額$1.95からです。

OTP Routeの請求は、1つのプリペイドUSDウォレットで行います。月額料金やプランはなく、カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届きます。リクエストに応じて、連携テスト向けに、模擬の番号とコードを使うサンドボックスモードを有効にできます。番号は、自社のプロダクトや正当なアカウントのテストと運用にのみ使い、各サービスの規約を尊重し、OTP Routeの利用規定（Acceptable Use Policy）が適用されることを忘れないでください。

よくある質問

QAチームは、ハンガリーのSIMなしでハンガリーのSMSコードを受信できますか？

はい。OTP Gatewayで対象サービス用の+36番号を注文し、コードをダッシュボードかAPI経由で受け取ります。

APIはハンガリーにどの国IDを使いますか？

hu を使います。たとえば、POST /api/v1/activations で {"service": "uber", "country": "hu"} のようなボディを送ります。

06 30 123 4567と書かれた番号は、どう変換すればよいですか？

トランクプレフィックスの 06 を取り除いて+36を付けると、+36301234567になります。このE.164形式で保存し、整形は表示時だけにしてください。

ハンガリーのルートがコードを配信しなかった場合、支払いは発生しますか？

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

ハンガリーのコードのメッセージが、英語のものと違って見えることがあるのはなぜですか？

ハンガリー語のテキストにはőやűが含まれることがあり、それによってメッセージがUCS-2エンコードになります。数字は同じで、メッセージの文面と長さだけが変わります。

数か月間保持できるハンガリーの番号は購入できますか？

セルフサービスの商品としては提供していません。Dedicated Numbersは米国とカナダのみです。ハンガリーについては、[email protected] にメールで問い合わせることができますが、手配できる確約はありません。

OTP Routeは、ハンガリーでいくつのサービスに対応していますか？

執筆時点で1,600を超えています。現在の一覧は、GET /api/v1/countries を呼ぶか、ダッシュボードで確認してください。

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