为什么团队需要不属于任何个人的 Shopee 号码？
设想一个团队在与电商平台做集成：订单同步、退货工具或店铺应用。QA 需要在某个特定的 Shopee 市场拥有买家账号，走完结账流程，确认集成表现正常。有人拿出自己的手机，于是一个测试账号就绑定在了某位员工位于某个国家的 SIM 卡上。
替客户开店的代理机构会遇到同样的问题，准备进入东南亚新市场的产品团队也一样。Shopee 的虚拟号码可以让这些验证不再占用私人手机，并让你选择测试真正涉及的国家。电商平台页面介绍了这一领域的团队如何使用 OTP Route。
Shopee 什么时候会要求手机验证码？
Shopee 把账号与手机号紧密绑定，一次性短信验证码通常出现在以下环节：
- 在买家应用或网站上使用手机号注册。
- 验证码登录，或在账号从未用过的设备上登录。
- 丢失密码时的密码重置与找回。
- 敏感变更，例如修改手机号、邮箱或收款信息。
- 卖家账号，在开设店铺时需要进行手机验证。
具体步骤因 Shopee 各国站点而异，并且会随时间变化，所以请把这当作通用模式，而不是固定的规则手册。
哪些国家可以接收 Shopee 验证码？为什么这很重要？
Shopee 线路在 197 个国家上线，包括印度尼西亚、马来西亚、菲律宾、越南、泰国、新加坡、台湾、巴西、墨西哥、哥伦比亚、智利、印度、美国、英国和澳大利亚。
Shopee 在每个市场都有独立的店铺站点，通常每个站点都期望使用本国的手机号。所以请选择与你测试的账号相符的国家：测试马来西亚店铺就需要马来西亚号码，而不是随便哪个碰巧便宜的号码。匹配市场也能让测试更真实，因为语言、货币和注册步骤都跟随店铺站点。
Shopee 验证码 API 如何使用？
使用基础 URL https://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。
获取验证码有两种方式：
- Webhook：订阅
activation.sms_received，以及activation.expired和activation.cancelled。校验X-OTPRoute-Signature头：用端点密钥对"<t>.<raw body>"计算 HMAC-SHA256，拒绝过期的时间戳，并通过只记录一次每个 activation id 来让处理程序保持幂等。 - 轮询：按一定间隔调用
GET /api/v1/activations/{id}，直到验证码出现或激活结束。
基于 webhook 的 OTP 捕获一文展示了可用于生产环境的接收端。
面向卖家和运营人员的控制台步骤
不是每个人都需要用 API。在控制台中：
- 用邮箱和六位验证码注册，或使用 Google 登录。
- 通过银行卡或 USDT/USDC 为钱包充值。
- 打开 OTP Gateway，选择 Shopee 和国家，并查看实时价格。
- 下单，然后把号码填入 Shopee 的手机号输入框。
- 验证码出现在号码旁边时读取它。
每次激活有 20 分钟窗口。只有验证码到达才会付费；否则款项会自动退回钱包。
Shopee 验证码为什么可能收不到？
有几件事可能造成阻碍。Shopee 可能在某些市场或流程中拒绝虚拟号码，自动退款正是为这种情况准备的。由于送达取决于服务和线路，某些时段线路也可能比较繁忙。
可以尝试：
- 让窗口完整地跑满 20 分钟，再放弃。
- 稍后重新下单，或者在测试允许的情况下尝试另一个国家的线路。
- 在自动化测试中为重试留出间隔；紧凑循环地重新下单很少有帮助。
关于电商平台流程的更完整排查清单，请阅读减少 OTP 投递失败。
什么时候 Dedicated Number 更合适？基本规则有哪些？
一次性号码适合单次验证。如果预发布环境的买家账号下周还要再次登录，或者共享的运营账号需要找回，那么续费期间归你持有的 Dedicated Number 更合适。它们在美国和加拿大即时提供，价格从 $1.95/month 起，入站短信显示在控制台，并推送到你的 webhook。详情见虚拟号码。
请只把 OTP Route 用于测试和运营你自己的合法账号与产品。遵守 Shopee 的条款，每个账号对应一位真实的个人或企业，并请记住 OTP Route 的《可接受使用政策》同样适用。Shopee 是其所有者的商标，OTP Route 与其没有关联。
常见问题
API 中 Shopee 的服务 id 是什么？
是 shopee。把它与国家 id 组合使用，例如印度尼西亚就是 {"service": "shopee", "country": "id"}。
我人不在某个市场，也能接收该市场的 Shopee 验证码吗？
可以，只要该国家在线路列表中。订购你正在测试的店铺站点所在市场的号码，然后远程读取验证码。
Shopee 会接受所有虚拟号码吗？
不会。Shopee 可能拒绝部分虚拟号码，所以没有收到验证码的激活会获得全额退款。
长期使用的测试账号应该用哪种 Shopee 手机号？
如果账号之后还要再次登录，续费期间归你持有的美国或加拿大 Dedicated Number 比一次性激活更合适。
CI 中支持 Shopee 短信验证测试吗？
支持。通过 API 创建激活，用签名 webhook 或轮询获取验证码，并可申请沙盒账号，在不花钱的情况下预演。
一条 Shopee 验证码要多少钱？
价格从 $0.20 per code 起；具体价格取决于国家，并由 GET /api/v1/prices 实时返回。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。