问题所在：南苏丹上线，但团队里没有本地 SIM 卡
设想一款已经服务东非的产品，正要把南苏丹加入国家选择器。QA 需要确认 +211 号码能通过校验、收到验证码，并让用户进入正确的页面。团队里没有人在朱巴，国际漫游很难安排，而借同事的私人手机来做测试账户是一个值得改掉的习惯。
远程的南苏丹验证号码解决了其中很具体的那部分问题：按需、通过脚本或浏览器，把一个真实的验证码送到 +211 线路上。我们的 QA 测试页面介绍了更完整的工作流程。
OTP Route 为 +211 号码提供什么？
OTP Gateway 会为一次验证分配一个南苏丹号码。选择服务和国家，在应用中使用该号码，验证码就会送达控制台和你的系统。激活会保持 20 分钟，只有短信到达时才需付费。
当前快照显示南苏丹有超过 900 项服务，包括 WhatsApp、Facebook、imo、Telegram、Instagram、TikTok、Snapchat、Viber、Signal、Google (Gmail & YouTube)、X (Twitter) 和 Uber。库存在一天之中会变动，所以请把它当作参考，运行前查询实时列表。
南苏丹 OTP API 在代码中如何使用？
把你的客户端指向 https://otproute.com/api/v1，并使用开发者控制台中的 Bearer 密钥（or_live_…）。国家 ID 是 ss。
GET /api/v1/prices?country=ss&service=<id>返回该组合当天的价格。POST /api/v1/activations，请求体为{"service": "imo", "country": "ss"}，预留号码。GET /api/v1/activations/{id}让你轮询验证码；POST /api/v1/activations/{id}/cancel可提前释放。
对于并行的测试套件，Webhook 优于轮询。订阅 activation.sms_received 和 activation.expired，校验 X-OTPRoute-Signature（用端点密钥对 <t>.<raw body> 计算 HMAC-SHA256），丢弃过期的时间戳，并让处理程序以激活 ID 保持幂等。流水线尤其受益，详见 CI 流水线中的短信 OTP 测试。每个账户最多可持有 10 个密钥和 5 个 Webhook 端点，吞吐量上限为每分钟 300 次请求。
手边没有开发人员？使用控制台
- 登录并打开 OTP Gateway。
- 选择南苏丹，然后选择你要测试的服务。
- 确认显示的价格，并复制 +211 号码。
- 在应用中输入该号码，并在同一页面上等待验证码。
- 如果测试取消，就取消订单；金额会退回钱包。
号码格式、语言与当地背景
南苏丹在 2011 年独立后获得了自己的国家代码 +211，因此较旧的联系人数据和一些老式校验库仍可能表现异常。国家代码之后的手机号有九位数字。在本地拨号书写时，通常带有开头的 0；转换为 E.164 时请去掉它，存储 +211 加九位数字。
英语是官方语言，朱巴阿拉伯语也被广泛使用，所以验证短信可能以英语或阿拉伯语送达，具体取决于应用的区域设置。测试这两种模板，以及任何阿拉伯语文案的从右向左渲染，是一个明智的补充。团队也会为人道主义和物流运营、区域企业账户，以及在海外保留 +211 号码的侨民用户在这里做测试。
验证码没有到达怎么办？
- 重试之前，先让 20 分钟的窗口走完。
- 检查该服务是否接受虚拟号码；有些服务会拒绝。
- 稍后再试，或换一条服务线路，不要快速循环地下单。
- 确认你的 Webhook 端点没有拒绝有效的签名。
已过期或已取消的激活会自动退款，无需申领。更多思路见减少 OTP 投递失败。
长期线路、钱包与沙盒
OTP Route 上没有自助开通的南苏丹长期号码。专属号码每月 $1.95 起，仅在美国和加拿大提供。如果你需要长期的 +211 线路，请写信至 [email protected]；能否安排取决于当地规定。
付款通过预付费美元钱包进行，没有月费：可用银行卡或 USDT/USDC 充值，每次充值都会收到 PDF 发票，实时费率见价格页面。开发阶段可按需启用沙盒模式，返回模拟的号码和验证码，这样在真正花钱之前就能验证集成。
常见问题
不在南苏丹，也能接收南苏丹的短信 OTP 吗？
可以。OTP Gateway 会远程提供一个 +211 号码，验证码会出现在控制台中，也可通过 API 获取。
南苏丹的 API 国家 ID 是什么？
创建激活或查询价格时使用 ss。
存储 +211 号码时应该保留开头的零吗？
不要。去掉本地的 0，存储 E.164 格式：+211 加九位数字。
有多少服务可以使用南苏丹号码？
实时列表目前包含超过 900 项服务，不过可用性在一天之中会变化。
我能在 CI 流水线中测试应用的南苏丹注册流程吗？
可以。在任务中用国家 ss 创建激活，通过签名 Webhook 接收 activation.sms_received，并在同一个测试步骤里提交验证码。沙盒账户让你无需花费钱包资金就能预演。
取消激活会怎么样？
全部金额会自动退回你的钱包，与 20 分钟窗口到期仍未收到验证码时相同。
用于测试的 +211 号码可以用于任何用途吗？
不可以。请用它测试或运营你自己的合法产品，遵守各服务的条款，并遵循 OTP Route 的《可接受使用政策》。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。