Tokopedia 在哪些环节会要求手机号？
Tokopedia 是印度尼西亚最大的在线电商平台之一，和大多数印尼的商务应用一样，它把手机号视为账号的核心部分。Tokopedia 通常在注册时要求手机号，在新设备登录时用它接收一次性验证码，并在修改收款信息或更换号码本身等敏感变更之前再次校验。卖家账号也要经过类似的确认步骤。
应用可能提供不止一种验证码渠道；OTP Route 接收的是短信线路，所以当应用询问时请选择短信。短信通常以印度尼西亚语发送。
在路由号码上接收 Tokopedia 验证码的正当理由包括：为你开发的卖家工具或店铺集成做 QA、代理机构代客户运营商家账号，以及希望把共享店铺登录从员工个人 SIM 卡上剥离的运营团队。电商平台解决方案页面介绍了这些做法。
Tokopedia 号码应该来自哪个国家？
实时快照显示 Tokopedia 在 197 个国家上线。请让号码与账号的真实市场相符：印度尼西亚（+62）号码适合典型的印尼卖家或买家账号，而来自其他地方的号码，则适合检查你自己的产品如何处理国际手机号输入。
列表中的其他国家还包括马来西亚、新加坡、文莱、菲律宾、泰国、越南、印度、澳大利亚、日本、韩国、香港、台湾、英国、荷兰和美国。测试用例应写明它预期的国家，这样失败时指向的就是流程本身，而不是不匹配的线路。
Tokopedia 验证码 API 的流程是怎样的？
使用前缀为 or_live_ 的 Bearer 密钥对 https://otproute.com/api/v1 进行认证。服务 id 是 tokopedia，印度尼西亚的国家 id 是 id。
- 查看
GET /api/v1/prices?country=id&service=tokopedia，了解实时价格和可用情况。 - 用
POST /api/v1/activations下单，请求体为{"service": "tokopedia", "country": "id"}。 - 把返回的号码填入你正在测试的注册或登录界面，并请求通过短信发送验证码。
- 从你的 webhook 读取结果，或轮询
GET /api/v1/activations/{id}，直到验证码出现。 - 如果测试中止，请调用
POST /api/v1/activations/{id}/cancel，款项会立即退回。
账号每分钟 300 次请求的上限，对轮询来说绰绰有余。完整的请求与响应格式见 API 文档。
Tokopedia 的 webhook 处理程序应该怎么写？
把你的五个 webhook 端点之一指向一个路由，让它监听 Tokopedia 订单的 activation.sms_received、activation.expired 和 activation.cancelled。每次投递都带有 X-OTPRoute-Signature: t=<unix>,v1=<hex>；用端点密钥对 <t>.<raw body> 计算 HMAC-SHA256，用恒定时间比较，并拒绝过期的时间戳。
以 activation id 为键让处理程序保持幂等，因为重试投递不能让同一个测试完成两次。如果你不想暴露端点，对于单个脚本，轮询同样适用。webhook 捕获指南提供了一个完整的设计示例。
不写代码，能用控制台处理 Tokopedia 验证码吗？
可以。打开 OTP Gateway，选择 Tokopedia，选好国家，并确认屏幕上显示的价格。把号码复制到 Tokopedia 应用中，选择短信作为渠道，验证码收到后会显示在激活旁边。商家运营负责人可以这样操作，而开发人员则用同一个钱包通过 API 工作。
Tokopedia 验证码为什么可能收不到？
有几件事可能阻止验证码：应用可能在某些流程中拒绝虚拟号码，可能会限制对同一号码的重复请求，或者验证码可能被发到了短信以外的渠道。线路在一天中的表现也会有所不同。
每次激活持续 20 分钟，只有验证码到达才会付费。如果什么都没有到，款项会自动退回钱包。让窗口跑完，稍后重试，或换一条适合该账号的其他国家线路，并避免紧凑循环地重新下单。我们的投递失败指南列出了更多检查项。
Tokopedia 店铺账号应该改用 Dedicated Number 吗？
一次性激活适合全新的注册测试。下个月还要再次登录的店铺账号，需要一个始终在你控制之下的号码，否则以后的登录验证码可能无处可去。Dedicated Number 可以在美国和加拿大覆盖这种情况，价格从 $1.95/month 起，入站短信显示在控制台，并转发到你的 number.sms_received webhook。美国或加拿大的号码是否适合某个 Tokopedia 账号，取决于账号本身，因此在依赖它之前请先确认。
负责任地测试 Tokopedia 的规则有哪些？
请遵守 Tokopedia 的条款，每个账号对应一位真实的个人或企业，并且只把 OTP Route 用于测试和运营你自己的合法产品与账号。该服务名称是其所有者的商标，OTP Route 与其没有关联。OTP Route 的《可接受使用政策》适用于每一笔订单。
计费使用预付的美元钱包，可通过银行卡、USDT 或 USDC 充值，每次充值都有 PDF 发票，没有月费。开发者账号可以申请沙盒模式，进行模拟的端到端测试。
常见问题
可以不借用团队成员的手机来测试卖家工具的 Tokopedia 登录吗？
可以。在 OTP Gateway 中订购 Tokopedia 激活，然后在控制台或通过 API 读取验证码。
API 中 Tokopedia 的服务 id 是什么？
是 tokopedia。与国家 id 搭配使用，例如印度尼西亚是 id。
Tokopedia 会接受所有虚拟号码吗？
不会。部分流程可能拒绝虚拟号码，所以没有收到验证码的激活会获得全额退款。
Tokopedia 手机号选哪个国家最好？
通常是印度尼西亚，因为大多数账号都在那里运营，但请选择与账号和测试用例相符的国家。
如果 Tokopedia 通过其他渠道发送验证码，我会被扣费吗？
如果号码上没有收到短信，就不会扣费。当 20 分钟窗口在没有任何内容的情况下结束，全额款项会退回你的钱包。
怎样避免重复的 webhook 投递破坏我的测试？
在校验每个请求的签名头之后，保存已处理的 activation id，并忽略重复项。
可以为 Tokopedia 店铺账号长期保留一个号码吗？
可在控制台获取美国和加拿大的 Dedicated Number；其他国家没有自助的长期号码。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。