ルクセンブルク+352のコード：最適なOTP Routeの製品を選ぶ

使い捨てコードか長期回線か：ルクセンブルクのプロジェクトに必要なのは？

すべてを左右する問いから始めましょう。そのアカウントは、同じ番号を再び必要とするでしょうか。

• 認証は1回きりで、それで終わり。 サインアップのテスト、ローカライズの確認、新しいステージングアカウントなどです。この場合はOTP Gatewayが合います。1回分のコード用に+352番号が得られ、ウィンドウは20分で、SMSが届かない限り料金はかかりません。
• アカウントが来月もログインする必要がある。 その場合は、保持し続ける番号が必要です。Dedicated Numbersは米国とカナダのみで、$1.95/月からです。ルクセンブルクの長期回線が必要なら、[email protected]にメールしてください。提供の可否は現地の規則によるため、お約束はできません。

テスト用アカウントが、フローを一通り試す間だけ存在すればよいなら、Gatewayの方がシンプルで安く済みます。両者を詳しく比べているのが、一時番号と専用番号の比較の記事です。

+352番号で認証できるサービスは？

ルクセンブルクの最新の一覧には、1,400を超えるサービスがあります。チームが最もよく使うのは、WhatsApp、LinkedIn、Microsoft＆Outlook、Amazon、Google（Gmail＆YouTube）、Telegram、Signal、Uber、Airbnb、Netflix、Claude、ChatGPT（OpenAI）です。

この一覧はスナップショットです。状況は一日の中で動くため、APIは固定のカタログではなく、今利用できるものを返します。

ルクセンブルクのOTP APIのフローはどう進むのか？

開発者コンソールのBearerキー（プレフィックスはor_live_）で、https://otproute.com/api/v1に対して認証します。流れは次のとおりです。

1. GET /api/v1/countriesでluを、GET /api/v1/servicesで対象サービスを確認します。
2. GET /api/v1/prices?country=lu&service=<id>で、最新の料金を読み取ります。
3. アクティベーションを作成します。POST /api/v1/activationsに{"service": "linkedin", "country": "lu"}を渡します。
4. GET /api/v1/activations/{id}をポーリングしてコードを取得するか、署名付きWebhookでactivation.sms_receivedを受け取ります。
5. テストを中止する場合は、POST /api/v1/activations/{id}/cancelでキャンセルします。

Webhookの呼び出しにはX-OTPRoute-Signature: t=<unix>,v1=<hex>が付きます。エンドポイントのシークレットで<t>.<raw body>のHMAC-SHA256を検証し、古いタイムスタンプは破棄してください。ハンドラーはアクティベーションIDをキーにして、再送された配信が無害になるようにします。知っておくべき上限は、1アカウントあたり、キー10個、Webhookエンドポイント5つ、1分あたり300リクエストです。コードサンプルはAPI連携ガイドをご覧ください。

クリックで済ませたい場合は、ダッシュボードでルクセンブルクとサービスを選び、価格を確認して、+352番号をアプリにコピーすれば、同じ画面にコードが表示されるのを待つだけです。

+352番号はどう整形して検証すればよいか？

ルクセンブルクにはトランクプレフィックスがないため、E.164への変換で取り除くものはなく、+352に国内の桁を続けるだけです。注意が必要なのは桁数です。ルクセンブルクの固定電話の番号は長さがまちまちですが、携帯番号は9桁で、たいてい6で始まります。

検証では、次のようになります。

• 国全体に固定長のルールを当てはめず、範囲を許容し、メンテナンスされている電話番号ライブラリに頼ります。
• 保存と比較の前にE.164へ正規化し、+352 621…と00352621…が一致するようにします。
• テストデータに、携帯番号の例を少なくとも1つ、短めの固定電話の例を1つ含めます。

ルクセンブルク市場向けにサインアップをテストするのはなぜか？

ルクセンブルクは小さな国ですが、プロダクトチームにとっては並外れて要求の高い市場です。ルクセンブルク語、フランス語、ドイツ語がすべて公用語で、職場では英語も一般的なため、1つのユーザー層が4つのインターフェース言語を求めることもあります。認証SMSの文面はアプリのロケールに従うので、ルクセンブルクは、出荷するすべてのテンプレートを手軽に試せる場所です。

また、フランス、ベルギー、ドイツからの越境労働者が多い欧州の金融センターでもあります。ユーザーが+352の番号を持ちながら、住所は隣国にあるという不一致が起こり得て、オンボーディングやリスクのルールはそれを適切に処理する必要があります。規制対象のサインアップを構築するチームは、フィンテックのオンボーディングのノートをご覧ください。

+352番号にSMSが届かないときはどうすればよいか？

• 何かを結論づける前に、アクティベーションを20分間フルに開いたままにします。
• そのサービスが仮想番号を受け付けるか確認します。ポリシー上、拒否するものもあります。
• 新しい注文を立て続けに出すのではなく、時間をおいて再試行するか、同じテストで別のサービスを試します。
• 届いたコードが隠れていないか、Webhookのログで署名エラーを調べます。

ウィンドウが期限切れになるかキャンセルすると、全額が自動でウォレットに戻ります。

ウォレットとサンドボックスはどう機能するのか？

OTP Routeは、プリペイドのUSDウォレット1つで運用されます。従量課金で、月額料金もプランの区分もありません。カードまたはUSDT/USDCでチャージでき、チャージのたびにPDFの請求書がメールで届きます。最新の料金は料金ページにあります。

+352の連携を組み込んでいる間は、開発用アカウントをサンドボックスモードに切り替えるよう依頼してください。模擬の番号とコードが返されるので、Webhookを含むフロー全体を、ウォレットを使わずに試せます。

よくある質問

テスト用のルクセンブルク認証番号は取得できるか？

はい。OTP Gatewayは1回分のコード用に+352番号を発行し、ダッシュボードで読み取るか、API経由で受け取れます。

APIでルクセンブルクに使う国IDは何か？

luです。POST /api/v1/activationsと価格のエンドポイントで使います。

ルクセンブルクの固定番号を購入できるか？

セルフサービスではできません。Dedicated Numbersは米国とカナダのみの販売です。ルクセンブルクについては、[email protected]までお問い合わせください。

ルクセンブルクのOTPメッセージは何語で届く可能性があるか？

アプリの言語設定によるため、フランス語、ドイツ語、英語、まれにルクセンブルク語のいずれもあり得ます。

コードが届かない場合、返金は自動か？

はい。20分のウィンドウが終わるまでにSMSが届かない場合、またはキャンセルした場合は、全額がウォレットに戻ります。

ルクセンブルクの電話番号は先頭に0を付けるか？

いいえ。トランクプレフィックスはないため、番号は+352に国内の桁をそのまま続けた形に変換されます。

これらの番号の使い方にルールはあるか？

あります。各サービスの規約とOTP RouteのAcceptable Use Policyを守り、自社の正当な製品とアカウントにのみ番号を使ってください。

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