首次 +27 下单之前：一份简短的准备清单
逐项核对，你的第一次南非激活应该能顺利完成：
- 钱包已充值。 一个预付费美元钱包支付所有费用；可用银行卡或 USDT/USDC 充值。不涉及订阅。
- 密钥已签发。 在开发者控制台生成 Bearer 密钥（以
or_live_开头）。为 CI 和预发布环境分别使用不同的密钥，总共最多 10 个。 - Webhook 已注册。 添加一个 HTTPS 端点并保存其签名密钥。最多可注册 5 个。
- 号码规范化已测试。 输入
082 123 4567这样的格式，确认输出为去掉前导 0 的+2782...。 - 服务 ID 已确认。 从
GET /api/v1/services获取目录，不要凭猜测填写 ID。 - 沙盒可选。 支持团队可以把开发账户切换为沙盒，让模拟的号码和验证码在产生任何真实花费之前先流经你的代码。
CI 测试指南介绍了如何把这些环节接入流水线。
南非号码应该如何存储和规范化？
南非使用冠码 0。本地书写的手机号为十位数字，例如 082 123 4567，在这种国内格式下，手机号段通常以 06、07 或 08 开头。国际格式中 0 会消失：同一条线路变成 +27 82 123 4567，去掉空格后是 +27821234567，即国家代码之后有九位数字。
典型的错误是存下了 +270821234567 这样的值，原因是表单在本地号码前直接拼上国家代码，却没有去掉 0。请在输入时规范化，只存储 E.164，并且仅为显示而渲染带空格的本地格式。如果你自己发送外呼短信，同样的规则也能让送达报告和用户查询保持一致。
哪些服务可以向南非验证号码发送验证码？
目前 za 的热门线路包括 WhatsApp、Facebook、Instagram、TikTok、Google (Gmail & YouTube)、Uber、Telegram、Microsoft & Outlook、LinkedIn、Netflix、Amazon、X (Twitter)、ChatGPT (OpenAI) 和 Discord。整个目录中，该国支持超过 1,700 项服务，而库存在一天之中会变动，所以当前可用性应以 API 为准。
为什么团队会选择这个市场？约翰内斯堡和开普敦是成熟的科技与金融中心，许多公司把南非作为整个南部非洲推广的基地。该国有多种官方语言，包括英语、祖鲁语、科萨语和南非荷兰语，但大多数验证短信以英文送达，所以本地化 QA 往往聚焦于周边页面，而不是短信文本本身。
步骤：在你的测试框架中调用南非 OTP API
请求发往 https://otproute.com/api/v1，携带你的 Bearer 密钥，每分钟最多 300 次。
GET /api/v1/prices?country=za&service=<id>返回你所需组合的实时价格。POST /api/v1/activations，请求体为{"service": "<id>", "country": "za"}，预留一个 +27 号码并返回激活 ID。- 你的测试把号码输入应用并触发短信。
activation.sms_received事件会送达你的 Webhook。在信任它之前，先用端点密钥重新计算<t>.<raw body>的 HMAC-SHA256，与X-OTPRoute-Signature中的v1比较，并丢弃时间戳过旧的请求。- 更喜欢轮询？请以平缓的间隔读取
GET /api/v1/activations/{id}。 - 被放弃的运行应调用
POST /api/v1/activations/{id}/cancel；GET /api/v1/balance可让任务在资金不足时提前停止。
关于线路选择的更多内容见OTP 国家路由。
运营人员使用控制台的步骤
无需编写代码：打开 OTP Gateway，选择南非和服务，查看显示的价格，确认后把 +27 号码粘贴到应用中。短信到达时会显示在激活页面上，20 分钟窗口和自动退款的机制与通过 API 使用时完全一致。
南非验证码迟迟不到的排查
首先是费用方面：如果 20 分钟内没有短信到达，或者你取消了订单，全部金额会自动退回钱包。然后再做诊断：
- 先保持耐心。 送达速度取决于服务和线路，所以让激活走完全程。
- 接受策略。 有些服务会拒绝虚拟号码；这种情况下退款是预期行为，而不是故障。
- 换个时间或线路。 稍后再试，或者在测试用例允许时，使用邻近线路，如纳米比亚或博茨瓦纳。
- 不要连续猛试。 取消后立刻重新下单很少有帮助，还会消耗你的速率限制。
号码只应用于测试你自己的产品或运营你自己的企业账户，请遵守各服务的条款，并请记住 OTP Route 的《可接受使用政策》同样适用。
南非的长期线路与计费模式
没有自助开通的长期 +27 号码。专属号码每月 $1.95 起，仅在美国和加拿大提供；需要长期南非线路的团队可以发邮件至 [email protected]，能否实现取决于当地规定。计费采用按量付费，从预付费钱包扣款，每次充值都会通过电子邮件发送 PDF 发票。完整信息见价格。
常见问题
没有本地 SIM 卡，也能测试我的应用的南非注册流程吗？
可以。通过 OTP Gateway 订购一个 +27 号码，在控制台或通过 API 读取验证码。每个验证码 $0.20 起，且只有验证码到达时才收费。
把南非号码转换为 E.164 时要保留前导 0 吗？
不要。去掉冠码 0，加上 +27 前缀，这样 082 123 4567 就变成 +27821234567。
南非的 API 国家 ID 是什么？
是 za，用于价格查询，以及创建 +27 激活时的 JSON 请求体。
南非的验证短信使用哪种语言？
大多是英语，尽管该国有多种官方语言。措辞由发送方的服务决定。
如果验证码从未送达，可以退款吗？
可以。激活会开放 20 分钟，如果没有任何短信到达或你取消了订单，全部金额会自动退回你的钱包。
我能购买一个南非号码长期保留几个月吗？
无法自助开通。专属号码是仅限美国和加拿大的产品；南非请发邮件给支持团队咨询，但不保证有货。
在 OTP Route 上，用 +27 号码可以验证多少种服务？
最新快照显示超过 1,700 种。请通过 API 查看实时目录，因为可用性在一天之中会变化。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。