日本語
プロダクト、QA、フィンテックチーム向けペルーの認証用番号
OTP Routeでは、OTP Gatewayで一時的な番号を注文し、SMSをダッシュボード、またはAPIと署名付きWebhookで読み取ることで、ペルー(+51)の認証コードを受信できます。料金は1コード$0.20〜で、20分以内に何も届かなければ、全額がウォレットに戻ります。
なぜペルーは、ラテンアメリカ向けの多くのテスト計画に登場するのですか?
ペルーは南米でも大きなスペイン語圏の市場のひとつで、スマートフォンユーザーはメッセージングとモバイル決済を多用します。YapeやPlinといった現地のウォレットのおかげで、電話番号によるサインアップが当たり前になっており、リマに参入するフィンテック、デリバリー、マーケットプレイスのプロダクトは、初日からSMSでユーザーを認証することが求められます。
チームがペルーに出会うのは、たいていコロンビア、エクアドル、チリ、ボリビアとともに行う地域展開の一環です。フロー自体は書類上では同じに見えますが、国ごとに番号の形が異なり、オンボーディングがそれを処理できると証明する手段が、テスト用の+51番号です。より広いパターンについては、フィンテックのオンボーディングのページで取り上げています。
ペルーの携帯番号はどう表記され、どう正規化しますか?
ペルーの携帯番号は9桁で、9から始まります。携帯はトランクプレフィックスなしでダイヤルするため、国際形式の完全な表記は +51 にその9桁を続けた、+519XXXXXXXX のような形になります。固定電話は異なり、市外局番があり、国内の市外通話では先頭に 0 が付きますが、これは国内ダイヤルのためのもので、E.164には決して含まれません。
バックエンドの実用的なルールは次のとおりです。
- 正規の値は1つだけ、
+51に国内の桁を加えたものとして、1つのカラムに保存する。 - ユーザーがスペース、ダッシュ、
0051プレフィックス付きで貼り付けた番号は、保存前にそれらを取り除く。 - 国内の桁が
0で始まる10桁の値は、トランクの桁を付けて入力された固定電話とみなし、そのゼロを取り除く。 - UIにはローカルの表示形式を使ってもよいが、SMS認証APIに送るのはE.164の文字列だけにする。
ペルーのコードはどの言語で届きますか?
人口の大半はスペイン語を話し、ケチュア語とアイマラ語も公用語です。ほとんどのサービスはペルーの番号にスペイン語で送りますが、文面は送信元とアカウントの言語設定によって変わります。そのため、抽出処理は「código」のようなフレーズではなく数字のまとまりを探すようにしてください。そうすれば、スペイン語、英語、ポルトガル語のどのテンプレートでも同じパーサーが機能します。ローカライズQAでは、実際のペルーの認証用番号を使えば、アクセント付き文字、コード入力画面、再送タイマーがスペイン語で正しく表示されることを確認できます。
どのアプリがペルーの認証用番号にコードをSMS送信できますか?
現在のスナップショットで人気のルートには、WhatsApp、Telegram、Google(Gmail & YouTube)、Facebook、Instagram、TikTok、X(Twitter)、ChatGPT(OpenAI)、Microsoft & Outlook、Amazon、Uber、LinkedIn、Netflix、AliExpress、Discordがあります。全体として、OTP Gatewayにはペルー向けに1,700を超えるサービスが掲載されています。
在庫は一日の中で動くため、正とすべきなのはライブのカタログです。実行の開始時に取得し、利用できないルートはスイート全体を失敗させず、スキップしてください。
ペルー OTP APIの連携はどのような形になりますか?
開発者コンソールでBearerキー(プレフィックス or_live_)を作成します。1つのアカウントでキーは最大10個、Webhookエンドポイントは最大5つまで持て、https://otproute.com/api/v1 に対して毎分300リクエストまで送れます。
典型的なジョブは次の順に動きます。まず GET /api/v1/prices?country=pe&service=uber で価格を確認し、次に POST /api/v1/activations に {"service": "uber", "country": "pe"} を渡して注文します。返された+51番号を、テスト対象のアプリに入力します。その後、サービス側がWebhookで activation.sms_received を受け取るか、コードが現れるまで GET /api/v1/activations/{id} をポーリングし、テストが早く終わった場合は POST /api/v1/activations/{id}/cancel を呼びます。GET /api/v1/balance は事前チェックに便利で、パイプラインが空のウォレットで始まることがなくなります。
各Webhookの X-OTPRoute-Signature ヘッダーは、エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を計算して検証し、古いタイムスタンプは拒否してください。実際の資金を使う前に、開発用アカウントでサンドボックスモードを依頼しましょう。シミュレーションされた番号とコードが返されるので、OTPルーティングの全経路をテストできます。より詳しい手順は連携ガイドにあります。
オペレーションチームは代わりにダッシュボードを使えますか?
使えます。コードはまったく不要です。ダッシュボードでOTP Gatewayを開き、ペルーを選び、サービスを選んで、表示された価格を確認し、確定します。+51番号をアプリにコピーしてSMSを発生させ、注文カードを見ていれば、コードが届いた時点でそこに表示されます。
各注文は20分間有効で、1つのコードに対応します。何も届かないままウィンドウが閉じた場合、またはキャンセルした場合は、お金が自動的にウォレットへ返金されるため、課金されるのはコードが本当に届いたときだけです。
+51のコードが表示されない場合は、何を試せばよいですか?
配信時間はサービスとルートによって異なるので、結論を出す前にウィンドウが終わるまで待ってください。ルートが静かなままの場合は次のようにします。
- 少し待ってから再試行するか、同じテストで別のサービスのルートに切り替える。
- 対象のサービスが仮想番号を受け付けるか確認する。拒否するサービスもあり、返金がそのケースをカバーします。
- 短い間隔で何度も注文し直すのではなく、自動化では再試行を抑制する。
ご利用は正当な目的に限ります。ご自身のプロダクトをテストし、ご自身の事業用アカウントを運用し、すべてのサービスの規約に従い、OTP Routeの利用規定(Acceptable Use Policy)が適用されることを忘れないでください。
ペルーの番号を長期間保持できますか?支払いはどうなりますか?
セルフサービスの製品としてはありません。専用番号(Dedicated Numbers)はアメリカとカナダのみで、月額$1.95からです。ペルーの長期回線については、[email protected]までご連絡ください。チームが現地の規制で何が認められるかを確認しますが、提供できるとは約束できません。
課金は、1つの前払いUSDウォレットで行います。従量課金で月額料金はなく、カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届きます。最新の内容は料金でご確認ください。
よくある質問
現地のSIMがなくても、アプリのペルー向けサインアップフローをテストできますか?
はい。OTP Gatewayの+51番号がコードを受信し、それをダッシュボードで読み取るか、APIで取得できます。
ペルーのOTP Routeの国IDは何ですか?
pe で、POST /api/v1/activations や GET /api/v1/prices などの呼び出しで使います。
ペルーの携帯番号は、E.164でトランクのゼロが必要ですか?
いいえ。携帯番号は9から始まる9桁で、ゼロなしで +51 にその桁を続けた形で保存します。
ペルーのSMS OTPを受信するにはいくらかかりますか?
1コード$0.20〜で、正確な金額はサービスによって異なります。20分のウィンドウ内にSMSが届かなければ、課金されません。
同じ+51番号は、後の2回目のログインにも使えますか?
いいえ、Gatewayの番号は1つのコードに対応します。繰り返しのログインには、アメリカまたはカナダの専用番号(Dedicated Number)が適しています。
チームでステーブルコインによる請求書の支払いはできますか?
はい。ウォレットはカードのほかUSDTとUSDCにも対応しており、チャージのたびにPDFの請求書がメールで届きます。
サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。