接收尼日利亚 OTP 需要调用哪些接口？
所有接口都位于 https://otproute.com/api/v1 之下，使用以 or_live_ 开头的 Bearer 密钥认证。尼日利亚的国家 id 是 ng。典型集成只需四次调用：
GET /api/v1/prices?country=ng&service=<id>：下单前确认当前价格。POST /api/v1/activations，请求体为{"service": "<id>", "country": "ng"}，预留一个 +234 号码。请保存返回的 activation id，之后每次调用和每个 Webhook 事件都以它为键。GET /api/v1/activations/{id}：读取状态，验证码送达后也从这里读取。POST /api/v1/activations/{id}/cancel：测试在上游失败、不再需要该号码时调用。
GET /api/v1/balance 很适合作为 CI 的前置检查，钱包余额不足时，夜间测试套件能够快速失败。OTP API 集成指南用同样的流程讲解了错误处理。
拉各斯的测试套件该用轮询还是 Webhook？
手动跑几次测试，轮询就够了。一旦流水线并行订购多个 +234 号码，Webhook 会更清爽。请在开发者控制台注册五个端点中的一个，并订阅 activation.sms_received、activation.expired 和 activation.cancelled。
每个请求都带有 X-OTPRoute-Signature: t=<unix>,v1=<hex>。请用端点密钥对时间戳、一个点号和原始请求体计算 HMAC-SHA256，以恒定时间比较，时间戳过旧就丢弃该请求。把已处理的 activation id 存起来，这样重复投递的事件就不会让测试触发两次。用 HMAC 保护 OTP Webhook一文有更完整的检查清单。每个账户的总流量请控制在每分钟 300 次请求以内；如果依赖事件而不是高频轮询，这个额度绰绰有余。
+234 线路上有哪些服务可用？
ng 线路目前提供 2,700 多种服务。常被请求的包括 WhatsApp、Telegram、Google (Gmail & YouTube)、TikTok、Facebook、Instagram、X (Twitter)、Snapchat、LinkedIn、Uber、Discord、Microsoft & Outlook、Amazon 和 ChatGPT (OpenAI)。库存会随着我们的运营商合作伙伴更新供应而在一天内变化，因此请查询实时可用性，不要想当然地认为昨天见过的服务现在还在。
团队为什么需要一个尼日利亚验证号码？
尼日利亚是非洲最活跃的金融科技和消费类应用市场之一，许多产品把手机号码当作主要身份标识。这使得短信验证成为钱包、借贷应用、网约车、配送和社交产品注册流程中的关键环节。境外团队使用 +234 测试号码，来确认注册流程、重发倒计时和错误提示文案对本地用户而言表现正常。
英语是官方语言，所以验证短信通常以英文送达，自动化测试里的断言逻辑也就更简单。金融科技团队尤其值得看看金融科技用户开通页面，了解它如何与 OTP Route 并不取代的身份核验配合使用。
尼日利亚手机号码是什么格式？
国家代码是 +234，国内长途前缀（trunk prefix）是 0。尼日利亚人通常把手机号写成以 0 开头的十一位数字，例如 0803 123 4567；写成国际格式时 0 要去掉，变成 +234 803 123 4567。请持久化保存 E.164 值（+234803...），输入时接受本地十一位格式，保存前去掉开头的 0。只检查总长度的校验器会放过 +2340803... 这样的号码，这是生产环境中发送失败的常见原因。
我可以改用控制台订购尼日利亚号码吗？
可以。用邮箱验证码或 Google 账号注册，给钱包充值，打开 OTP Gateway，选择尼日利亚和服务，确认显示的价格即可。号码立即可用，验证码到达后会显示在订单旁边。
如果没有收到，请让 20 分钟的窗口走完；只有验证码送达才需付费，过期或取消的订单会自动退款。然后过一会儿重新下单，在测试允许的情况下改用其他线路，例如加纳，并检查该服务是否拒绝虚拟号码。请避免连续快速地反复下单。
长期尼日利亚线路、计费与沙盒是怎样的？
OTP Route 不提供可自助开通的尼日利亚长期号码。专用号码（Dedicated Numbers）只在美国和加拿大销售，$1.95/月起。如果需要长期的 +234 线路，请发邮件至 [email protected]；能否提供取决于当地法规。
费用从一个预付美元钱包中扣除，没有套餐，也没有月费。可以用银行卡或 USDT/USDC 充值，每次充值都会收到 PDF 发票。请支持团队把开发账户切换为沙盒模式，您的集成将收到模拟的号码和验证码，让您无需花费钱包资金就能测试完整的 Webhook 链路。
常见问题
没有本地 SIM 卡，能测试我的应用的尼日利亚注册流程吗？
可以。在 OTP Gateway 订购一个 +234 号码，然后在控制台或通过 API 读取验证码。
OTP Route API 中尼日利亚的国家 id 是什么？
在价格查询和激活请求中，把 ng 作为 country 值。
接收尼日利亚短信验证码要多少钱？
每条验证码 $0.20 起，具体金额取决于服务，并由价格接口返回。
没收到短信我还要付费吗？
不用。如果 20 分钟内没有任何短信，或者您取消了订单，全额退回钱包。
像 0803 123 4567 这样的号码该怎么存储？
去掉开头的零，保存为 +2348031234567，即不含空格的 E.164 格式。
这些号码可以用于任何账户吗？
仅限用于您自己的合法产品和账户。请遵守各服务的条款以及 OTP Route 的可接受使用政策；有些服务会直接拒绝虚拟号码。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。