产品和 QA 团队需要了解的萨摩亚概况
萨摩亚是太平洋上的独立国家，官方语言为萨摩亚语和英语。大量萨摩亚人生活在新西兰、澳大利亚和美国，因此汇款、即时通讯和旅行类应用常常需要照顾在这些国家与家乡之间往来的用户。
有两点值得注意。第一，萨摩亚（+685）与美属萨摩亚是两个不同的国家，后者属于北美编号计划，区号为 +1 684；在国家选择器里把它们混淆，验证码就会发到错误的地方。第二，萨摩亚在 2011 年改到国际日期变更线西侧，时间比 UTC 快很多，正好可以用来测试验证码过期逻辑中的日期边界。
对产品团队来说，萨摩亚很少单独作为发布市场。它通常出现在太平洋地区的整体上线计划中，或是面向海外侨民的应用的需求里，又或是阿皮亚的合作机构需要确认一个企业账号。无论哪种情况，任务都一样：证明 +685 用户能走完你的注册流程。
代码里该如何处理 +685 号码？
与大多数市场相比，萨摩亚的国内号码很短，因此按九位或十位号码调优的校验器可能会拒绝真实号码。请将号码保存为 +685 加国内数字，不带任何分隔符，并去掉用户出于习惯多输入的 0。由于 Webhook 时间戳是 Unix 秒，请统一按 UTC 比较，而不要用本地时间；这样可以避免服务器与身处萨摩亚的测试人员处于不同日期时出现意外。
如果你的产品允许用户在同一个资料中切换新西兰号码和萨摩亚号码，请加一条测试：更换国家代码后确认旧的验证状态已被清除，这样发给其中一个号码的验证码就不会被另一个号码接受。
萨摩亚线路上有哪些服务可用？
萨摩亚目录当前列出超过 600 项服务。常被请求的有 WhatsApp、Facebook、Instagram、Telegram、Google（Gmail 和 YouTube）、Viber、Signal、TikTok、Microsoft 和 Outlook、Amazon 以及 Discord。这里的覆盖范围比大型市场窄，并且会在一天中变化，所以每次运行前请先查看 GET /api/v1/services 和 GET /api/v1/countries。如果某项服务缺失，也可以考虑用邻近线路来测试，例如 Fiji 或 Tonga。
目录较小，正是让测试框架保持宽容的理由：如果运行时首选服务不可用，就把该用例标记为跳过而不是失败，并做好记录，以便之后有人重试。
通过 API 请求萨摩亚验证码
使用 Bearer 密钥（or_live_…）访问 https://otproute.com/api/v1，先通过 GET /api/v1/prices?country=ws&service=<id> 查询价格，再向 POST /api/v1/activations 提交 {"service": "<id>", "country": "ws"}。你可以轮询 GET /api/v1/activations/{id} 来跟踪激活 id，也可以监听 activation.sms_received。请验证每个 Webhook 上的 X-OTPRoute-Signature HMAC，拒绝过期的时间戳，并让处理程序对同一激活重复执行也是安全的。完整流程见集成指南。
对这样规模的市场来说，速率限制很宽松：每个账户最多 10 个密钥、5 个 Webhook 端点，每分钟 300 次请求。如果采用轮询，每次检查间隔几秒就足够了。
在控制台手动操作
- 登录并打开 OTP Gateway。
- 选择服务，然后选择萨摩亚。
- 查看实时价格并确认。
- 将 +685 号码粘贴到被测应用中，请求验证码。
- 在屏幕上读取验证码；如果不再需要，可以取消。
+685 验证码很慢或收不到时怎么办
请让激活保持完整的 20 分钟，再决定放弃。有些应用会完全拒绝虚拟号码，这正是未收到短信的订单会被退款的原因。如果某条线路一直没有动静，可以稍后再试，或换用其他服务线路；在短时间内连续下单通常没有帮助，还会消耗你的速率限制。
每次尝试都记录激活 id，这样你就能判断沉默是出在某个特定应用，还是整条线路。
长期号码与按量付费
OTP Route 不提供可自助购买的萨摩亚长期号码。专属号码（Dedicated Numbers）每月 $1.95 起，仅限美国和加拿大；如果需要萨摩亚线路，请发邮件至 [email protected] 咨询，但不保证能够办理。预付美元钱包支持银行卡和 USDT/USDC，每次充值都会发送 PDF 发票，且没有月费。你可以为开发账户申请沙盒模式，在不花费资金的情况下演练 ws 流程。
常见问题
在电话号码方面，萨摩亚和美属萨摩亚是一回事吗？
不是。萨摩亚使用 +685，美属萨摩亚使用 +1 684。请在国家选择器和 API 中选对。
萨摩亚的 API 国家 id 是什么？
在价格查询和激活请求中使用 ws。
一条萨摩亚验证码多少钱？
每条验证码 $0.20 起；具体价格取决于服务，下单前会显示出来。
我可以在新西兰或澳大利亚测试萨摩亚用户的注册流程吗？
可以。+685 号码会接收短信，无论你的团队在哪里办公，OTP Route 都会把它显示给你。
收不到短信时需要付费吗？
不需要。过期或已取消的激活会自动退款到钱包。
萨摩亚的验证码使用什么语言？
通常是英语，英语与萨摩亚语同为官方语言。请解析数字，而不是周围的文字。
我可以用这些号码开很多账号吗？
不可以。请遵守各服务的条款；根据《可接受使用政策》，OTP Route 仅限于测试并运营你自己的合法账户和产品。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。