Shopeeの認証コードを個人の電話から切り離して受信する

なぜ、誰の私物でもないShopee用の番号が必要なのですか？

マーケットプレイスとの連携を開発しているチームを想像してください。注文同期、返品ツール、ストアアプリなどです。QAは、チェックアウトを通して連携の動作を確認するために、特定のShopee市場のバイヤーアカウントを必要とします。誰かが自分の電話を取り出し、テストアカウントが1人の社員のSIMと1つの国に結びついてしまいます。

クライアントのためにショップを立ち上げる代理店や、東南アジアの新市場でのローンチを準備するプロダクトチームも、同じ問題に直面します。Shopee用の仮想番号を使えば、こうした確認を私用の電話から切り離し、テストが実際に対象とする国を選べます。この分野のチームがOTP Routeをどう使っているかは、マーケットプレイスのページで説明しています。

Shopeeはいつ電話コードを求めますか？

Shopeeはアカウントを電話番号と密接に結びつけており、ワンタイムSMSコードは一般に次のような場面で表示されます。

• 登録：バイヤーアプリまたはウェブサイトで電話番号を使って登録するとき。
• コードによるログイン、またはアカウントが未使用の端末でサインインするとき。
• パスワードのリセットと、パスワードを紛失したときの回復。
• 重要な変更：電話番号、メールアドレス、支払い先情報の編集など。
• 出品者アカウント：ショップの設定時に電話認証を通します。

具体的な手順はShopeeの国別サイトで異なり、時期によっても変わるため、これは固定のルールブックではなく一般的なパターンとして捉えてください。

Shopeeのコードを受信できるのはどの国で、なぜ重要なのですか？

Shopeeのルートは197か国で提供されており、インドネシア、マレーシア、フィリピン、ベトナム、タイ、シンガポール、台湾、ブラジル、メキシコ、コロンビア、チリ、インド、アメリカ、イギリス、オーストラリアなどが含まれます。

Shopeeは市場ごとに別のストアフロントを運営しており、それぞれが一般に自国の電話番号を想定しています。そのため、テスト対象のアカウントに合う国を選んでください。マレーシアのストアフロントのテストには、たまたま安いだけの番号ではなく、マレーシアの番号が必要です。市場に合わせると、言語、通貨、オンボーディングの手順がストアフロントに沿うため、テストも現実的になります。

Shopee認証コードAPIはどのように動きますか？

ベースURLhttps://otproute.com/api/v1と、or_live_で始まるBearerキーを使います。GET /api/v1/prices?country=my&service=shopeeで対象市場の料金を確認し、POST /api/v1/activationsに{"service": "shopee", "country": "my"}のボディを渡してアクティベーションを作成します。国IDはGET /api/v1/countriesから取得します。

配信には2つの選択肢があります。

• Webhook：activation.sms_receivedに加え、activation.expiredとactivation.cancelledを購読します。エンドポイントのシークレットで"<t>.<raw body>"のHMAC-SHA256を計算してX-OTPRoute-Signatureヘッダーを検証し、古いタイムスタンプは拒否して、各アクティベーションIDを1回だけ記録することでハンドラーを冪等にします。
• ポーリング：コードが表示されるかアクティベーションが終了するまで、一定間隔でGET /api/v1/activations/{id}を呼び出します。

本番環境で使えるレシーバーは、Webhookによる番号取得の記事で紹介しています。

出品者と運用担当者向けのダッシュボード手順

全員がAPIを必要とするわけではありません。ダッシュボードでは次のようにします。

1. メールと6桁のコード、またはGoogleで登録します。
2. カードまたはUSDT/USDCでウォレットにチャージします。
3. OTP Gatewayを開き、Shopeeと国を選んで、最新の料金を確認します。
4. 注文し、番号をShopeeの電話番号欄に入力します。
5. 番号の横にコードが表示されたら読み取ります。

各アクティベーションには20分の受付時間があります。料金が発生するのはコードが届いた場合のみで、届かなければ金額は自動的にウォレットに戻ります。

Shopeeのコードが届かないのはなぜですか？

いくつかの要因が考えられます。Shopeeが一部の市場やフローで仮想番号を拒否することがあり、自動返金はその状況のためにあります。配信はサービスとルートに左右されるため、時間帯によってルートが混み合うこともあります。

試すこと：

• あきらめる前に、20分の受付時間が終わるまで待つ。
• 時間をおいて再注文するか、テストが許せば別の国のルートを試す。
• 自動テストでは再試行の間隔を空ける。短い間隔での再注文はほとんど効果がありません。

マーケットプレイスのフローを対象にした、より詳しいトラブルシューティングの一覧は、OTP配信の失敗を減らす方法をお読みください。

Dedicated Numberが適しているのはどんなときで、基本ルールは何ですか？

ワンタイム番号は1回の認証に向いています。来週もログインが必要なステージング用のバイヤーアカウントや、回復が必要な共有の運用ログインには、更新している間は保持できるDedicated Numberが適しています。アメリカとカナダですぐに利用でき、月額$1.95 からで、受信SMSはダッシュボードとWebhookで受け取れます。詳細は仮想番号をご覧ください。

OTP Routeは、自社の正当なアカウントとプロダクトのテストと運用にのみ使用してください。Shopeeの規約に従い、アカウントは実在の個人または事業者につき1つとし、OTP RouteのAcceptable Use Policyが適用されることを忘れないでください。Shopeeは権利者の商標であり、OTP Routeとは提携関係にありません。

よくある質問

APIでのShopeeのサービスIDは何ですか？

shopeeです。国IDと組み合わせて使います。たとえばインドネシアなら{"service": "shopee", "country": "id"}です。

自分がいない市場のShopee OTPを受信できますか？

はい、その国がルートに含まれていれば可能です。テストするストアフロントの市場の番号を注文し、リモートでコードを読み取ります。

Shopeeはすべての仮想番号を受け付けますか？

いいえ。Shopeeが一部の仮想番号を拒否することがあります。そのため、コードが届かなかったアクティベーションは全額返金されます。

長期間使うテストアカウントには、どのShopee用電話番号を使うべきですか？

アカウントが後でまたログインする必要があるなら、ワンタイムのアクティベーションよりも、保持できるアメリカまたはカナダのDedicated Numberが適しています。

CIでShopeeのSMS認証テストは使えますか？

はい。APIでアクティベーションを作成し、署名付きWebhookまたはポーリングでコードを受け取ります。資金を使わずに試したい場合はサンドボックスアカウントを申請してください。

Shopeeのコードはいくらですか？

1コード$0.20 からです。正確な料金は国によって異なり、GET /api/v1/pricesがリアルタイムで返します。

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