チェックリスト：OTP Routeの番号でeBayのSMSコードを受信する

eBayはいつ電話番号を求めますか？

eBayは、複数の場面で電話番号を使います。登録時に番号を確認したり、2段階認証の方法としてテキストメッセージのコードを提供したり、サインインが普段と違うと判断したときにコードを送ったり、出品者アカウントの設定中に確認済みの番号を求めたりします。マーケットプレイス連携、出品ツール、社内のQAスイートが再現する必要があるのは、まさにこうした場面です。OTP RouteはeBayと提携しておらず、その名称は権利者の商標です。

典型的な依頼は3つのグループから来ます。動作するテストアカウントが必要な出品・注文同期ツールのエンジニア、より広いマーケットプレイス連携の中でeBayのログインを承認しなければならないQAチーム、そしてアカウント回復を個人の電話ではなくチームが管理する番号で受けたい運用担当者です。最後のケースについては、マーケットプレイス向けソリューションのページで解説しています。

注文前のチェックリスト

• まず市場を決める。 番号の国は、テストするeBayサイトとアカウントに合わせてください。英国の出品者フローには英国の番号が必要です。
• 料金と空き状況を確認する。 GET /api/v1/prices?country=<id>&service=ebayで確認します。
• ウォレットにチャージする。 カードまたはUSDT/USDCで行います。購入するプランはありません。
• Webhookエンドポイントを登録する。 そのシークレットを保存するか、ポーリングで進めることを決めます。
• eBayのユーザー規約を読む。 アカウントが実在の個人または自社事業のものであることを確認します。
• サンドボックスモードを申請する。 自社のコードパスだけを動かしたい場合は、開発アカウントで申請します。

eBayのルートがある国はどこですか？

ebayサービスは198か国で提供されています。チームが最初に選ぶのは、eBayが現地サイトを運営している市場で、アメリカ、イギリス、ドイツ、イタリア、オーストラリア、フランス、スペイン、カナダ、オーストリア、アイルランド、ベルギー、スイス、オランダ、ポーランド、香港などです。アカウントの本拠地の市場を選ぶと、アカウントが想定する住所、通貨、言語と認証の整合性が保たれます。

複数のeBayサイトをテストする場合は、テスト設定にサイトからapi_countryの値への小さな対応表を持たせておくと、テスト対象のアカウントと常に同じ市場から番号を取得できます。

APIの手順を順に見る

1. Developerコンソールでキーを作成します。or_live_で始まり、Bearerヘッダーでhttps://otproute.com/api/v1に渡します。
2. gbやdeのようなapi_countryの値を使い、POST /api/v1/activationsに{"service": "ebay", "country": "<id>"}を渡して呼び出します。
3. 返された番号をeBayに入力し、テキストメッセージを要求します。
4. エンドポイントでactivation.sms_receivedを待ち、X-OTPRoute-Signature（"<t>.<raw body>"のHMAC-SHA256）を確認し、古いタイムスタンプは拒否して、再送されても影響が出ないよう、アクティベーションIDをキーに処理します。
5. または、1分あたり300リクエストを超えないように、GET /api/v1/activations/{id}をポーリングします。
6. テストを中止する場合は、POST /api/v1/activations/{id}/cancelを呼び出します。

自動化された実行にこれを組み込む方法は、CIパイプラインのガイドで紹介しています。

ダッシュボードから同じことを行う

OTP Gatewayを開き、eBayを検索して国を選び、最新の料金を確認して番号をコピーします。それをeBayに貼り付け、コードを要求すると、アクティベーションパネルにコードが表示されます。20分の受付時間と返金ルールは、API経由の場合と同じです。

四半期に1、2回しかアカウント認証をしない技術職以外の同僚には、通常こちらの方法が好まれます。自動化されたスイートはAPIを使うべきです。

eBayのコードが届かないときのトラブルシューティング

• eBayは一部のフローで仮想番号を拒否することがあります。自動返金がその場合に対応します。
• キャンセルする前に、受付時間が終わるまで待つ。
• 短い間隔で再注文するのではなく、時間をおいて、またはアカウントに合う別の国のルートで再試行する。
• eBayのフォームの国選択が、番号の国番号と一致しているか確認する。

さらなるヒントは、OTP配信の失敗を減らす方法の記事にあります。

試行のたびにアクティベーションIDと国を記録してください。特定のサイトやフローがあるルートを拒否し続けている場合、パターンがすぐに見えてきます。

Dedicated Numberのほうが適している場合

ゲートウェイ番号は1つのコードを処理すると消えるため、チームが毎週ログインする出品者アカウントやステージングアカウントには不向きです。その場合は、アメリカまたはカナダのDedicated Number（月額$1.95 から）が、ダッシュボードとnumber.sms_receivedでテキストを受信し続け、アカウントを廃止するときにはいつでも解約できます。両方の比較は仮想番号のページにあります。どちらを選んでも、OTP Routeは自社の正当なeBayアカウントとプロダクトのテストと運用のためのもので、Acceptable Use Policyが適用されます。

よくある質問

SIMカードなしでeBayのOTPを受信できますか？

はい。ebayサービスのOTP Gateway番号を注文すれば、コードがダッシュボードに表示されるか、API経由で届きます。

OTP Route APIでeBayに使うサービスIDは何ですか？

サービスIDはebayで、アクティベーションのリクエストで国IDとともに使います。

eBayの認証番号は何か国で提供されていますか？

eBayのルートは現在198か国で提供されています。利用可否は変動するため、実行のたびに最新の一覧を確認してください。

テスト用のeBay SMS認証はいくらですか？

1コード$0.20 からで、正確な料金は国によって異なり、料金エンドポイントが返します。

eBayが私の仮想番号を拒否したのはなぜですか？

一部のeBayのフローは仮想番号を拒否します。コードが届かなければ課金されないため、時間をおいて、またはアカウントに合う別の国のルートで再試行してください。

チームで共有するeBay出品者アカウントには、どの番号タイプが適していますか？

アメリカまたはカナダのDedicated Numberです。手元に残り、後のサインインコードも受信できるためです。

OTP Routeの番号を使って、停止されたeBayアカウントを復活させられますか？

いいえ。eBayの規約に従い、アカウントは実在の個人または事業者につき1つとし、サービスは自社の正当なプロダクトにのみ使用してください。

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