QA・ローンチチーム向けのエルサルバドル(+503)認証コード

エルサルバドルのテストには、1回限りのコードと長期回線のどちらが必要ですか?

まずテストの形から考えてください。それがどの製品を使うかを決めます。

• 単一の認証ステップ(サインアップ、電話番号の変更、追加認証のチェックなど)は、OTP Gatewayに当てはまります。1つのサービス向けに+503番号を注文すると、コードが一度届き、その番号の役目は終わります。
• 数週間にわたってログインし続ける必要があるアカウントには、自分で保有する回線が必要です。専用番号(Dedicated Numbers)は米国とカナダ向けの製品で、1か月$1.95からです。ダッシュボードから即時に購入でき、SMSの受信、SMSの送信、ブラウザからの通話に対応しています。

エルサルバドルにはセルフサービスの専用番号がありません。エルサルバドルの長期回線が本当に必要な場合は、[email protected]までメールしてください。手配できるかどうかは現地の規制によるもので、保証はできません。「繰り返しのログイン」のケースは、テスト対象のサービスが認める場合、代わりに米国の回線で解決するチームも多くあります。エルサルバドルでの展開に向けては、使い捨て番号と専用番号の比較のノートを参考に、両方の道を比べてみてください。

+503番号はどのように保存・検証すべきですか?

エルサルバドルは8桁のクローズドな番号体系を採用しており、トランクプレフィックスはありません。現地の人がフォームに書く番号は、国際的に+503の後に続く8桁と同じなので、正規化は主に記号を取り除く作業になります。現地の人は、携帯番号を4桁ずつ2つのブロックに分けてハイフンでつないで書くことがよくあります。

• E.164形式、つまり+503に8桁を続けたものを、1つのカラムに保存します。
• 携帯番号は一般に6または7で始まり、固定電話は通常2で始まります。先頭の数字をそれだけに限るバリデーターで、ほとんどの入力ミスを捕まえられます。
• 余分な先頭の0は拒否します。他のラテンアメリカの番号体系に慣れているユーザーが0を付けてしまうことがあり、SMSプラットフォームによっては、メッセージを黙って破棄します。

この市場向けのアプリのSMSテンプレートは、通常スペイン語です。á、í、óなどの文字は基本のGSMアルファベットに含まれないため、これらを使うテンプレートはUCS-2エンコーディングに切り替わり、1セグメントあたりの文字数が短くなることがあります。メッセージが分割されても残るよう、コードはメッセージの冒頭近くに置いてください。

チームはなぜエルサルバドルでサインアップフローをテストするのですか?

いくつかのパターンが繰り返し出てきます。

• 中米でのローンチ。グアテマラ、ホンジュラス、エルサルバドルにまたがって展開するプロダクトは、広告を出す前に、各国の電話認証のステップを確認したいと考えます。
• 在外の顧客。多くのサルバドール人が米国に住み、家族のために+503番号を持ち続けています。そのため、送金、決済、メッセージングのプロダクトは、ユーザーの住所が米国であっても、サルバドールの番号を目にします。そのフローについては、フィンテックのオンボーディングをご覧ください。
• ローカライズQA。スペイン語の文面、国選択、番号マスクは、画面がエンドツーエンドで動作することを確認するために、実際のサルバドールのコードを必要とします。
• 米ドルでの価格設定。米ドルはエルサルバドルの公式通貨なので、この市場はチェックアウトとオンボーディングを一緒にテストするのに便利です。

エルサルバドルOTP APIの呼び出し手順はどうなりますか?

すべてのリクエストは、Developerコンソールで作成したor_live_で始まるBearerキー(最大10個、1分300リクエスト)を付けてhttps://otproute.com/api/v1に送ります。エルサルバドルの国IDはsvです。

1. GET /api/v1/countriesとGET /api/v1/servicesを取得し、IDをキャッシュします。
2. GET /api/v1/prices?country=sv&service=<id>でリアルタイム価格を取得します。ここからは、ルートが今利用できるかどうかもわかります。
3. {"service": "telegram", "country": "sv"}のようなボディでPOST /api/v1/activationsを呼び、注文を作成します。アクティベーションIDと番号を保存します。
4. アプリのサルバドール向けビルドから、その番号に認証SMSを送らせます。
5. エンドポイントに届くactivation.sms_receivedイベントを待ちます。イベントがない場合は、数秒おきにGET /api/v1/activations/{id}をポーリングします。
6. フローを中断する場合は、POST /api/v1/activations/{id}/cancelを呼んで、資金をすぐに戻します。

すべてのWebhookにはX-OTPRoute-Signature: t=<unix>,v1=<hex>が付いており、これはエンドポイントのシークレットを使った、タイムスタンプ、ドット、生のボディに対するHMAC-SHA256です。検証を行い、古いタイムスタンプは破棄してください。OTP Webhookの保護で手順を解説しています。開発者でない人も、ダッシュボードから同じことができます。エルサルバドルを選び、サービスを選び、リアルタイムの価格を確認すると、アクティベーションカードにコードが表示されます。

サルバドールの番号で認証できるサービスはどれですか?

最新のスナップショットでは、エルサルバドルのルートを持つサービスが900を超えています。人気のあるものは、WhatsApp、Facebook、Instagram、TikTok、Uber、Google (Gmail & YouTube)、Microsoft & Outlook、Amazon、Telegram、Signal、LinkedIn、ChatGPT (OpenAI)です。提供状況は日中に変動します。だからこそ、固定のリストではなく価格エンドポイントでテストランナーを動かすべきです。

仮想番号に分類した番号を拒否するサービスもあります。それは当社の管理の及ばないことであり、返金ルールが存在する理由です。

サルバドールのコードが届かない場合はどうなりますか?

+503のコードが遅いからといって、まだ失敗とは限りません。注文は20分間そのままにしておいてください。何も届かなければ注文は期限切れとなり、activation.expiredが発火し、全額が自動的にウォレットへ戻ります。そのうえで、次を試してください。

• この種のステップで、サービスが仮想番号を受け付けているかを確認します。
• 短い間隔で再注文を繰り返さず、時間をおいて再試行するか、別のサービスルートを選びます。
• 自社アプリが、返されたとおりのE.164形式の番号に、実際にSMSを送ったことを確認します。

中米に即したトラブルシューティングは、OTP配信失敗を減らす方法にも載っています。

エルサルバドルの注文の料金はどのように処理されますか?

OTP Routeは、前払いのUSDウォレットを1つ使う従量課金で、月額料金もプラン選択もありません。クレジットカード、またはUSDT/USDCのステーブルコインでチャージでき、チャージや番号の購入のたびにPDFの請求書が受信トレイに届きます。連携の開発中は、リクエストに応じて開発用アカウントをサンドボックスに切り替えられます。シミュレーションされた番号とコードが返されるため、ウォレットの残高を使わずに一連の流れ全体を実行できます。現在の料金は料金ページにあります。

よくある質問

現地のSIMがなくても、自社アプリのエルサルバドル向けサインアップをテストできますか?

はい。テストするサービス向けにOTP Gatewayで+503番号を注文し、SMSを発生させて、コードをダッシュボードまたはAPIで読み取ります。

サルバドールの番号には、0のようなトランクプレフィックスがありますか?

いいえ。エルサルバドルの番号は8桁でトランクプレフィックスがないため、国際形式は+503にその8桁を続けたものになります。

OTP Route APIでのエルサルバドルの国IDは何ですか?

価格の照会とアクティベーションのボディでsvを使います。たとえばGET /api/v1/prices?country=sv&service=<id>です。

+503番号がコードを受信しなかった場合も課金されますか?

いいえ。20分の有効時間内にSMSが届かなかった場合、または先にキャンセルした場合は、全額がウォレットに自動的に返金されます。

リピートログイン用にサルバドールの番号を保持できますか?

セルフサービスの製品としては提供していません。長期の専用番号は米国とカナダで提供しています。エルサルバドルについては、[email protected]にメールでお問い合わせいただけますが、提供できるという約束はできません。

OTP Routeは、多数のアカウントを作るためのものですか?

いいえ。自社の正当なプロダクトとアカウントのテストと運用のためのもので、各サービスの利用規約とOTP Routeの利用規定(Acceptable Use Policy)の範囲内で使用します。

お金をかけずに、CIでサルバドールのフローを実行できますか?

はい。リクエストに応じて開発用アカウントをサンドボックスに切り替えられ、シミュレーションされた番号とコードが返されるため、パイプラインでAPIの一連の経路を検証できます。

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