テスト・運用アカウント向けAmazon電話番号認証の進め方

ワンタイムコードか、保持する番号か。Amazonアカウントにはどちらが必要?

最初にここを決めてください。Amazonアカウントは、一度きりでなく何度もコードを求めることが多いためです。

• OTP Gateway番号: ストアフロント連携やローカライズされたサインアップ画面が想定どおり動くかを確認する、1回限りの認証に向いています。番号は1つのコードのために確保され、その後に解放されます。
• 専用バーチャル番号(Dedicated Virtual Number): 2段階認証を有効にした後や、チームメンバーが新しいブラウザからサインインするときなど、アカウントが再びコードを求める場合に向いています。米国とカナダで月額$1.95から利用でき、受信SMSはnumber.sms_received経由でWebhookに転送されます。

目安として、来週そのAmazonアカウントにログインする人がいるなら、専用番号に載せてください。テスト中に1回だけコードが必要なら、OTP Gatewayのほうが安価でシンプルです。両者の違いは一時番号と専用番号の比較で解説しています。

AmazonはいつSMS認証コードを送信しますか?

Amazonは、よく知られたいくつかの場面でワンタイムパスワードを使います。

• アカウント作成: 多くの地域で、サインアップ時に携帯電話番号を認証できます。
• 2段階認証: 新しい端末やブラウザでサインインするたびに、SMSでコードを受け取る設定にできます。
• アカウント復旧: パスワードの再設定をコードで確認するときです。
• 出品者・法人の登録: 連絡用電話番号の確認が含まれます。

最後の点はマーケットプレイスのチームにとって重要です。出品者としてのIDは長く使われるため、一度きりの経路ではなく、自社が長期にわたって管理する番号に紐づけるべきです。

AmazonのOTPコードを受信できるのはどの国ですか?

amazonサービスは現在202か国で利用できます。問い合わせの多い国には、アメリカ、イギリス、ドイツ、日本、インド、メキシコのほか、カナダ、フランス、イタリア、スペイン、ブラジル、オーストラリア、オランダ、ポーランド、トルコ、シンガポール、サウジアラビア、アラブ首長国連邦などがあります。

テスト対象のアカウントに合わせて国を選んでください。Amazonは地域ごとに別のストアを運営しているため、ドイツ向けのサインアップテストにはドイツの番号を使い、実際の顧客が目にする流れ、言語、入力検証のルールと一致させます。全一覧は国別ページにあります。

Amazon認証コードAPIをテストに組み込むにはどうしますか?

Bearerキー(プレフィックスor_live_)を使ってhttps://otproute.com/api/v1にリクエストします。サービスIDはamazon、国IDは対象市場のもの(deやjpなど)です。

1. GET /api/v1/prices?country=<id>&service=amazonで、現在の価格と空き状況を取得します。
2. POST /api/v1/activationsに{"service": "amazon", "country": "<id>"}を送ると、番号が確保され20分間のウィンドウが開きます。
3. テスト対象のAmazonのフォームに番号を入力します。
4. Webhookでactivation.sms_receivedを処理します。X-OTPRoute-Signature(エンドポイントのシークレットによる<t>.<raw body>のHMAC-SHA256)を検証し、古いタイムスタンプは拒否し、再配信が無視されるようアクティベーションIDを記録します。
5. 環境上Webhookが現実的でない場合は、1分あたり300リクエストの上限内で適切な間隔を空けてGET /api/v1/activations/{id}をポーリングします。
6. 中断した実行はPOST /api/v1/activations/{id}/cancelでキャンセルします。

開発アカウントに申請して有効にできるサンドボックスモードでは、疑似的な番号とコードが返されるため、CIでウォレット残高を使わずに連携処理全体を検証できます。

AmazonのOTPをダッシュボードから受け取る方法はありますか?

あります。OTP Gatewayを開き、Amazonと国を選び、価格を確認して番号をコピーします。その番号をAmazonに貼り付けてコードを要求し、アクティベーションを開いたままにしておくと、メッセージが届いた時点で番号の横に表示されます。マーケットプレイスの運用担当者や代理店のスタッフはこの方法を使い、エンジニアは同じウォレットからAPIを使うことが多いです。

Amazonのコードが届かないのはなぜですか?

Amazonは他の大手プラットフォームと同様に、一部のバーチャル番号を拒否することがあり、リスク判定によって理由を示さず番号が弾かれる場合もあります。そのほか、その時点でルートが混雑している、再送ボタンを早く押しすぎた、といった原因が考えられます。ウィンドウが終わるまで待ってください。何も届かないまま閉じた場合や、キャンセルした場合は、全額が自動的に返金されます。時間をおいて再試行するか、テストに合う別の国のルートを試してください。また、注文エンドポイントをループで連打するのは避けましょう。

Amazonでの責任ある利用とは?

出品者アカウントと購入者アカウントのルールを含め、Amazonの利用規約に従ってください。アカウントは実在する1人または1事業者につき1つとし、OTP Routeは自社の連携のテスト、または組織が所有する正当なアカウントの運用にのみ使ってください。プロモーションやレビューを悪用する目的でアカウントを作成しないでください。Amazonはその権利者の商標であり、OTP Routeとは提携関係にありません。すべての注文にOTP Routeの利用規定(Acceptable Use Policy)が適用されます。典型的なパターンはマーケットプレイスの活用例をご覧ください。

よくある質問

自分の携帯電話を使わずに、テスト用のAmazon OTPを受け取れますか?

はい。amazonサービスのOTP Gateway番号を注文し、ダッシュボードまたはAPIでコードを確認します。

2段階認証が必要なアカウントには、どのAmazon用電話番号を使うべきですか?

米国またはカナダの専用バーチャル番号(月額$1.95から)です。2段階認証では、以後のサインインのたびに新しいコードが送られるためです。

テスト用のAmazon SMS認証の料金はいくらですか?

料金は1コード$0.20〜で、国によって異なります。支払いはコードが届いた場合のみです。

Amazonはすべてのバーチャル番号を認証に受け付けますか?

いいえ。Amazonが一部のバーチャル番号を拒否することがあるため、SMSが届かなかったアクティベーションは全額返金されます。

番号の国はAmazonのストアに合わせるべきですか?

できれば合わせてください。ストアと同じ市場の番号を使うと、サインアップ時の言語や入力検証が、現地の顧客と同じになります。

Amazonのコードを受け取るWebhookが本物かどうかは、どう確認しますか?

エンドポイントのシークレットでHMAC-SHA256を再計算してX-OTPRoute-Signatureヘッダーと照合し、古いタイムスタンプのリクエストは拒否してください。

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