准备清单：申请尼泊尔号码之前需要备好什么？
做一次简短的准备，可以省去后面许多令人困惑的调试。在第一次下单之前，请确保你已具备：
- 凭据。 在开发者控制台生成一个
or_live_密钥，并作为 Bearer 令牌发送。为本地开发、CI 和生产工具使用不同的密钥，轮换起来很轻松。 - 国家与服务 id。 尼泊尔是
np；用GET /api/v1/services查找服务 id。 - 资金或沙盒。 检查
GET /api/v1/balance，或申请把你的开发账户切换到沙盒，这样模拟号码和验证码可以免费测试集成。 - 投递方式的选择。 在编写测试框架之前就决定使用 Webhook 端点还是轮询，而不是写到一半才定。
- 支持 Unicode 的收件视图。 尼泊尔语模板的验证码会以天城文到达，你的日志应能正确显示它们。
如果你对这种模式还不熟悉，什么是 OTP 网关用几分钟时间讲清了背景。
哪些应用可以向 +977 线路发送验证码？
目前有超过 1,700 个服务可以路由到尼泊尔。热门的有 Viber、WhatsApp、Facebook、Instagram、TikTok、Telegram、Google（Gmail 和 YouTube）、Microsoft 和 Outlook、Discord、Signal、imo、Amazon 和 Claude。
这份列表是快照，而不是承诺。可用性在一天中会变化，所以 GET /api/v1/prices?country=np&service=<id> 会针对你的测试所需的确切组合返回实时价格和可用性。
分步操作：通过 API 接收尼泊尔短信 OTP
准备清单完成后，尼泊尔 OTP API 流程最多只需五次调用：
- 确认
np和你的服务的实时价格。 - 用
POST /api/v1/activations创建激活，请求体为{"service": "<id>", "country": "np"}。保存返回的激活 id；后续一切都以它为键。 - 在被测流程中输入 +977 号码，并触发短信。
- 从
activation.sms_receivedWebhook 收集验证码，或以合理的间隔轮询GET /api/v1/activations/{id}。 - 如果测试提前中止，用
POST /api/v1/activations/{id}/cancel取消。
在 Webhook 一侧，信任请求之前请先验证 X-OTPRoute-Signature：构造 <t>.<raw body>，用端点密钥进行 HMAC-SHA256 签名，与 v1 比对，并拒绝过期的时间戳。然后以激活 id 为键做 upsert，这样重复投递的事件不会造成问题。基于 Webhook 的 OTP 捕获展示了完整的模式。
更喜欢点击而不是编码？在 OTP Route 控制台选择尼泊尔，选择服务，接受显示的价格，号码就会连同计时器一起出现；验证码会显示在同一个界面上。
尼泊尔手机号的格式检查
尼泊尔手机号为十位，以 9 开头，常见为 98 或 97。在国内，固定电话号码拨打时是长途前缀 0 加区号，但这个 0 从不属于国际格式。因此，测试记录应该类似 +97798xxxxxxxx。
验证测试中值得断言的事项：
- 用户输入带前导 0 的号码时，+977 之后的 0 会被去掉。
- 不带任何前缀的十位手机号能被接受，并规范化为 E.164。
- 用户从通讯录卡片粘贴的空格和短横线，在存储前会被清除。
短信内容同样值得检查。尼泊尔语使用天城文书写，天城文短信以 Unicode 发送，每段允许的字符数远少于普通拉丁文本。如果你的验证模板做了本地化，请确认验证码仍然落在单个分段内，没有因为周围的文字而被挤到拆分点之外。许多服务只是发送英文模板，所以两种都要测试。
团队为什么要为尼泊尔市场开发和测试
尼泊尔对许多产品的重要性超出其规模。大量尼泊尔劳工生活在国外，所以服务海湾、马来西亚等汇款通道的汇款、钱包和通讯类产品，往往需要验证仍持有 +977 号码的用户。Viber 和 WhatsApp 等通讯应用是当地日常沟通的一部分。
团队在以下情形订购 +977 测试号码：
- 为尼泊尔用户上线注册流程，需要证明国家出现在选择器中，且掩码正确。
- 检查入门和找回界面上的尼泊尔语字符串。
- 复现海外侨民客户关于登录验证码从未到达的报告。
移动应用验证页面展示了应用团队如何组织这类国家覆盖。
排错：验证码没有到达
验证码缺失有几个常见原因，解决办法很少是立刻再次下单。
- 先耐心等待。 让激活走完完整的 20 分钟；排队的短信确实也会迟到。
- 虚拟号码政策。 有些服务会拒绝虚拟号码。出现这种情况时，激活只会过期，退款会进入钱包。
- 路由选择。 稍后再试，或为同一服务使用不同的路由，而不是反复冲击同一个。
- 请求频率纪律。 紧凑循环重新下单会耗尽每分钟 300 次请求的限制，也很少有帮助。
- 你自己的应用。 确认发送短信的请求确实已触发；在日志中检查外发请求。
activation.expired 事件是明确的信号，说明没有任何短信到达，也没有收费。
长期线路与尼泊尔路由的付款
OTP Route 没有自助的尼泊尔长期号码。专属号码（Dedicated Numbers）仅存在于美国和加拿大，$1.95/月起。如果你的团队需要持久的 +977 线路，请写信至 [email protected]；能否安排取决于当地规定，不作任何保证。
付款采用一个预付费美元钱包按量支付，可通过银行卡或 USDT、USDC 充值，每次充值都会通过邮件发送 PDF 发票，没有月费。关于费用如何显示，请见定价；也可以注册，用邮箱验证码或 Google 创建账户。
常见问题
没有尼泊尔 SIM 卡，也能接收尼泊尔 OTP 吗？
可以。OTP Gateway 会为一次验证分配一个 +977 号码，你可以在控制台或通过 API 读取验证码。
API 对尼泊尔期望使用哪个国家代码？
在价格和激活请求中，将 np 作为国家发送。
存储尼泊尔号码时应该保留前导 0 吗？
不应该。去掉长途前缀 0，将号码以 E.164 格式存储在 +977 之后。
尼泊尔语的验证码在控制台中能正确显示吗？
消息按收到的内容显示；请确保你自己的日志和测试断言能处理天城文，这样才能可靠地提取验证码。
如果尼泊尔验证码一直没来，我的钱会怎样？
不会收费：激活的 20 分钟内没有收到短信，或你取消了，都会全额退回钱包，无需你提出任何请求。
之后登录时能再次使用同一个 +977 号码吗？
不能，每个 OTP Gateway 号码只对应一条验证码。需要之后再次登录的账户适合使用专属号码，但它们仅在美国和加拿大提供。
尼泊尔验证号码有使用规则吗？
有。请遵守各服务的条款和《可接受使用政策》，仅将这些号码用于测试或运营你自己合法的产品和账户。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。