リヒテンシュタインのOTP API：QAと市場ローンチ向け+423コード

+423番号は近隣国の番号と何が違うのか？

リヒテンシュタインはクローズドな番号計画を採用しています。加入者番号は7桁で、トランクプレフィックスはありません。そのため、住民が国内でダイヤルする7桁が、そのまま+423の後ろに付ける7桁になります。国境の両側にあるスイスやオーストリアでは、E.164を組み立てる前に先頭の0を取り除く必要があるのとは異なります。

データベースのルールは1つで済みます。+423の後ろにちょうど7桁を続けて保存し、それより長いものは推測せずに拒否することです。フォームの検証をスイスやオーストリアの番号向けに作っている場合は、ローンチ前に+423の入力でテストしてください。それらの計画からコピーした桁数チェックは失敗します。

このような小さな市場で、プロダクトチームがテストするのはなぜか？

リヒテンシュタインは欧州経済領域（EEA）の加盟国で、通貨はスイスフラン、公用語はドイツ語です。この組み合わせは、DACH地域へのローンチにとって便利なエッジケースになります。片側にEEAの規則、もう片側にスイス式の価格設定があり、文言はすべてドイツ語です。この市場向けにローカライズされた認証テンプレートは、通常ドイツ語で届きますが、アカウントの言語設定によっては、国際的なサービスの多くが英語で送ってきます。

この国には金融やトラスト関連の産業も大きく、資産運用や銀行のアプリは、+423番号でオンボーディングが最後まで通るか確認する必要がよくあります。このような国別のケースを回帰テストスイートに組み込む方法は、QAテストのガイドをご覧ください。

リヒテンシュタインの番号でどのサービスを認証できるか？

liの今日のスナップショットでは、人気のルートとして、Telegram、Google（Gmail＆YouTube）、WhatsApp、Facebook、Instagram、Microsoft＆Outlook、Amazon、LinkedIn、Signal、Viber、Uber、Airbnbが掲載されています。この国は合計で300を超えるサービスに対応しています。利用状況は一日の中で変わるため、保存した一覧に頼らず、その都度確認してください。

SMS認証APIで+423のコードをリクエストするには？

+423のリクエストはすべてor_live_のBearerキーを付け、https://otproute.com/api/v1を対象にします。

1. GET /api/v1/servicesでサービスIDを調べます。
2. GET /api/v1/prices?country=li&service=<id>で価格と可用性を確認します。
3. アクティベーションを作成します。POST /api/v1/activationsに{"service": "<id>", "country": "li"}を渡します。
4. Webhookでactivation.sms_receivedを受け取ります。その際、X-OTPRoute-Signature（<t>.<raw body>のHMAC-SHA256）を検証し、古いタイムスタンプは破棄します。または、GET /api/v1/activations/{id}をポーリングします。
5. テスト実行が途中で終わったときは、POST /api/v1/activations/{id}/cancelでキャンセルします。

同じOTPルーティングの流れを、リトライとログ出力つきで示したのが連携ガイドです。

エンジニアでなくてもダッシュボードから注文できるか？

はい。ダッシュボードでOTP Gatewayを開き、リヒテンシュタインとサービスを選び、表示された価格を確認して、番号をアプリに貼り付けます。コードは、受信するとすぐにアクティベーションのページに表示され、同じ20分のウィンドウが適用されます。

この方法は、サポートやコンプライアンスの担当者が、リヒテンシュタインのSMS OTPを1回だけ受信したい場合に向いています。たとえば、ドイツ語のオンボーディング画面がテスト用の7桁の+423番号を受け付けるかを確かめるとき、エンジニアにスクリプトを書いてもらう必要はありません。価格は確定前に見られ、返金ルールもAPI経由と同じなので、手動での試行が失敗しても費用はかかりません。

リヒテンシュタインのコードが届かないときは何を確認すべきか？

コードが届かなくても費用はかかりません。ウィンドウが閉じるかキャンセルすると、自動で返金されるためです。そのうえで、よくある原因を順に確認してください。

• サービスとルートによってタイミングが変わるため、アクティベーションにウィンドウの全時間を与えます。
• そのサービスが仮想番号を受け付けるか確認します。拒否するものもあります。
• 時間をおいてやり直すか、テストが許すならスイスやオーストリアなど近隣のルートを使います。
• 続けざまに再注文しないでください。

アクティベーションは、自社製品または自社の業務用アカウントにのみ結び付け、各サービスの規約を守ってください。OTP RouteのAcceptable Use Policyも適用されます。

リヒテンシュタインの固定回線はあるのか、支払いはどうなるのか？

セルフサービスの製品としてはありません。Dedicated Numbersは米国とカナダでのみ提供され、$1.95/月からです。長期の+423回線が必要な場合は、[email protected]までメールをお送りください。提供の可否は現地の規則によります。支払いは、カードまたはUSDT/USDCでチャージするプリペイドのUSDウォレットで行い、チャージごとにPDFの請求書が発行されます。詳細は料金ページにあります。

よくある質問

現地のSIMなしで、アプリのリヒテンシュタイン向けサインアップフローをテストできるか？

はい。OTP Gatewayは1回分のコード用に+423番号を発行し、ダッシュボードで確認するか、Webhookで受け取れます。料金は$0.20/コードからです。

リヒテンシュタインの番号は、スイスの番号のように0で始まるか？

いいえ。リヒテンシュタインにトランクプレフィックスはないため、国内形式でも国際形式でも、番号は+423に7桁を続けたものです。

リヒテンシュタインでは、コードからどの国IDを送ればよいか？

countryフィールドにliを送ります。サービスIDはGET /api/v1/servicesで調べられます。

認証SMSは何語で届くか？

公用語はドイツ語なので、ローカライズされたテンプレートは通常ドイツ語です。ただし、アカウントの言語設定によっては、国際的なサービスの多くが英語で送ってきます。

コードが届かなかった場合、課金されるか？

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

お金をかけずに連携を試せるか？

はい。リクエストに応じて、サポートが開発用アカウントをサンドボックスに切り替えられます。エンドツーエンドのテスト用に、模擬の番号とコードが返されます。

+423のコードはどのくらいの速さで届くか？

決まった数値はありません。配信はサービスとルートによって異なるため、アクティベーションはウィンドウの全時間にわたって有効なままです。

リヒテンシュタインでOTP Routeを使うのに月額料金はかかるか？

いいえ。プリペイドのUSDウォレットからの従量課金で、選ぶプランはなく、チャージごとにPDFの請求書がメールで届きます。

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