自社のテスト・運用アカウントのために、ルーティングされた番号でTokopediaのOTPを受信する

Tokopediaはどこで電話番号を求めますか？

Tokopediaはインドネシア最大級のオンラインマーケットプレイスの1つで、インドネシアの多くのコマースアプリと同様に、電話番号をアカウントの中核として扱います。Tokopediaの電話番号は、一般に登録時に求められ、新しい端末でのログイン時のワンタイムコードに使われ、支払い先情報の編集や番号自体の変更といった重要な変更の前に再度確認されます。出品者アカウントも、同様の確認ステップを通ります。

アプリはコードの送信チャネルを複数提供することがあります。OTP Routeが取得するのはSMSのルートなので、アプリから聞かれたらSMSを選んでください。メッセージは通常インドネシア語で届きます。

ルーティングされた番号でTokopediaのOTPを受信する正当な理由としては、自社が開発する出品者ツールやストア連携のQA、クライアントに代わって加盟店アカウントを運用する代理店、共有のショップログインを社員の個人SIMから切り離したい運用チームなどがあります。こうした構成はマーケットプレイス向けソリューションのページで説明しています。

Tokopediaの番号はどの国のものにすべきですか？

最新のスナップショットでは、Tokopediaは197か国に掲載されています。番号は、アカウントの実際の市場に合わせてください。インドネシア（+62）の番号は典型的なインドネシアの出品者・バイヤーアカウントに合い、他国の番号は、自社プロダクトが国際的な電話番号入力をどう扱うかの確認に役立ちます。

リストにあるその他の国には、マレーシア、シンガポール、ブルネイ、フィリピン、タイ、ベトナム、インド、オーストラリア、日本、韓国、香港、台湾、イギリス、オランダ、アメリカなどがあります。テストケースには想定する国を明記しておくと、失敗したときに、ルートの不一致ではなくフロー自体に原因があると判断できます。

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

or_live_で始まるBearerキーでhttps://otproute.com/api/v1に認証します。サービスIDはtokopediaで、インドネシアの国IDはidです。

1. GET /api/v1/prices?country=id&service=tokopediaで、最新の料金と空き状況を確認します。
2. POST /api/v1/activationsに{"service": "tokopedia", "country": "id"}のボディを渡して注文します。
3. テスト中の登録画面またはログイン画面に、返された番号を入力し、SMSでコードを要求します。
4. Webhookから結果を読み取るか、コードが表示されるまでGET /api/v1/activations/{id}をポーリングします。
5. テストが中止された場合は、POST /api/v1/activations/{id}/cancelを呼び出すと、資金がすぐに戻ります。

アカウントあたり1分300リクエストの上限は、ポーリングには十分です。リクエストとレスポンスの詳しい形式はAPIドキュメントにあります。

TokopediaのWebhookハンドラーはどう書くべきですか？

5つあるWebhookエンドポイントのうち1つを、Tokopediaの注文に対するactivation.sms_received、activation.expired、activation.cancelledを待ち受けるルートに向けます。各配信にはX-OTPRoute-Signature: t=<unix>,v1=<hex>が含まれます。エンドポイントのシークレットで<t>.<raw body>のHMAC-SHA256を計算し、定数時間で比較して、古いタイムスタンプは拒否してください。

再送された配信が同じテストを二度完了させないよう、アクティベーションIDをキーにしてハンドラーを冪等にします。エンドポイントを公開したくない場合は、単一のスクリプトならポーリングでも同様に機能します。設計例はWebhookによる番号取得ガイドにあります。

ダッシュボードだけで、コードを書かずにTokopediaのコードを扱えますか？

はい。OTP Gatewayを開き、Tokopediaを選び、国を選んで、画面上の料金を確認して確定します。番号をTokopediaアプリにコピーし、チャネルとしてSMSを選ぶと、受信後にアクティベーションの横にコードが表示されます。加盟店の運用リーダーがこの方法を使い、その間に開発者は同じウォレットからAPIを使えます。

TokopediaのOTPが届かないのはなぜですか？

コードが止まる原因はいくつかあります。アプリが一部のフローで仮想番号を拒否する、同じ番号への繰り返しのリクエストを制限する、コードがSMS以外のチャネルに送られた、などです。ルートも1日の中で変動します。

各アクティベーションは20分間続き、料金が発生するのはコードが届いたときだけです。何も届かなければ、金額は自動的にウォレットに戻ります。受付時間が終わるまで待ち、時間をおいて、またはアカウントに合う別の国のルートで再試行し、短い間隔での再注文は避けてください。さらなる確認事項は、配信失敗に関するガイドに一覧があります。

Tokopediaのショップアカウントは、代わりにDedicated Numberに置くべきですか？

ワンタイムのアクティベーションは、新規登録のテストに向いています。来月もログインが必要なショップアカウントには、手元で管理できる番号が必要です。そうでないと、将来のログインコードの届け先がなくなる可能性があります。アメリカとカナダでは、Dedicated Numbersがこの場合に対応します。月額$1.95 からで、受信SMSはダッシュボードに表示され、number.sms_receivedのWebhookにも転送されます。アメリカやカナダの番号がTokopediaのアカウントに適しているかどうかはアカウント自体によるため、頼る前に確認してください。

責任を持ってTokopediaをテストするためのルールは何ですか？

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

課金は、カード、USDT、USDCでチャージする前払いUSDウォレットで行われ、チャージごとにPDFの請求書が発行され、月額料金はありません。開発者アカウントは、サンドボックスモードを申請して、シミュレートされたエンドツーエンドのテストを行えます。

よくある質問

チームメンバーの電話を使わずに、出品者ツールのTokopediaログインをテストできますか？

はい。OTP GatewayでTokopediaのアクティベーションを注文し、ダッシュボードまたはAPIでコードを読み取ります。

APIでTokopediaに使うサービスIDは何ですか？

tokopediaです。インドネシアならidのような国IDと組み合わせて使います。

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

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

Tokopediaの電話番号には、どの国が最適ですか？

ほとんどのアカウントが運用されているインドネシアが通常は最適ですが、アカウントとテストケースに合う国を選んでください。

TokopediaがOTPを別のチャネルで送った場合も課金されますか？

番号にSMSが届かなければ課金されません。20分の受付時間が何も届かないまま終了すると、全額がウォレットに戻ります。

重複したWebhook配信でテストが壊れないようにするには？

各リクエストで署名ヘッダーを検証したうえで、処理済みのアクティベーションIDを保存し、重複を無視します。

Tokopediaのショップアカウント用に、番号を長期間保持できますか？

Dedicated Numberはダッシュボードからアメリカとカナダで利用できます。それ以外の国には、セルフサービスの長期回線はありません。

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