请求 +375 号码之前，需要准备好什么？
在使用 +375 号码做测试之前，请逐项确认：
- 一个账户和已充值的钱包。 在 /signup 用电子邮箱和 6 位邮件验证码，或通过 Google 登录创建账户，然后充入少量余额。为持有 API 密钥的账户开启 TOTP 双重验证。
- 一个 Bearer 密钥，带有
or_live_前缀，在开发者控制台创建。请给 CI 和本地开发分别分配密钥；一个账户最多可持有 10 个。 - 你要发送的两个 ID。 白俄罗斯在 API 中是
by，服务 ID 是GET /api/v1/services返回的api_service值。 - 一个接收端点，如果你打算使用 Webhook，并把它的签名密钥存放在代码仓库之外。
- 你自己产品里的一个测试账户，且该账户被允许更改或添加手机号。
- 按区域 BY 配置的号码库，这样你粘贴到注册表单里的号码，会按真实白俄罗斯用户的输入方式被解析。
白俄罗斯号码怎么写？你的应用应如何存储？
白俄罗斯使用国家代码 +375，后接九位国内号码。手机号以 25、29、33 或 44 等运营商代码开头，所以存储的值形如 +37529XXXXXXX。
棘手的是国内的习惯。国内的人常把手机号写成以 80 开头，例如 8 029 XXX-XX-XX，这来自长途拨号前缀。在加上国家代码之前必须去掉这个 80；保留它的表单会生成无效的 E.164 字符串，有些验证服务会悄悄拒绝。白俄罗斯验证号码的良好规范化测试包括：
- 接受
+375 29 ...、375 29 ...和8 029 ...，并把这三种形式存成完全相同的值； - 以便于本地用户阅读的分组方式显示号码，但只向你的短信或验证层发送 E.164；
- 拒绝
375之后仍带有80的号码。
白俄罗斯语和俄语都是官方语言，而日常使用最多的是俄语。许多服务会根据账户区域用俄语或英语发送验证码文本，因此请检查你的应用在任何回显短信内容的页面上都能正确渲染西里尔字母。
白俄罗斯验证号码可以接收哪些服务的验证码？
OTP Route 的白俄罗斯 OTP 路由目前以 ID by 覆盖超过 1,400 项服务。当前快照中比较热门的线路包括 Telegram、Viber、WhatsApp、Signal、Google (Gmail & YouTube)、Instagram、TikTok、Microsoft & Outlook、LinkedIn、Discord、Amazon 和 AliExpress。
任何一条线路的可用性在一天中都会变化，所以请把这样的列表当作起点，而不是承诺。运行之前，请用 GET /api/v1/prices?country=by&service=<id> 查询当前价格，以及该线路此刻能否接单。在选择国家时，请参阅OTP 的国家路由。
分步操作：测试脚本中的白俄罗斯 OTP API 流程
所有请求都发往 https://otproute.com/api/v1，并带上你的 Bearer 密钥。这套短信验证 API 足够小，可以封装进一个辅助函数：
- 调用
GET /api/v1/balance，如果钱包余额不足以跑完整个套件，就提前终止任务。 - 调用
GET /api/v1/prices?country=by&service=telegram（换成你的服务 ID），并记录你将要支付的价格。 - 用
POST /api/v1/activations创建订单，请求体类似{"service": "telegram", "country": "by"}。保存响应中的激活 ID 和 +375 号码。 - 把该号码提交到你自己应用的手机号步骤，并触发验证码。
- 从
activation.sms_received事件中获取验证码，或轮询GET /api/v1/activations/{id}。限制为每分钟 300 次请求。 - 如果测试中止，调用
POST /api/v1/activations/{id}/cancel，冻结的金额会立即回到钱包。
对于 Webhook，请读取 X-OTPRoute-Signature 请求头（t=<unix>,v1=<hex>），用端点密钥计算 <t>.<raw body> 的 HMAC-SHA256，用恒定时间比较，并丢弃时间戳过期的投递。让你的处理程序以激活 ID 为键，这样重复投递也不会有副作用。API 文档和用 HMAC 保护 OTP Webhook 的指南涵盖了细节。
分步操作：在控制台完成同样的工作
偶尔需要验证码的客服人员可以跳过 API：
- 在控制台打开 OTP Gateway，选择白俄罗斯。
- 选择服务；确认之前会显示该线路的价格。
- 复制 +375 号码，输入到你正在测试的应用中。
- 观察订单卡片。验证码一到就会显示在那里。
如果 20 分钟内没有任何短信到达，订单会关闭，全部金额会退回。只有验证码送达时你才需要付费。
故障排查：+375 的验证码没有到
常见原因及对应的下一步：
- 服务拒绝了该号码。 有些平台会拒绝虚拟号码。退款规则正是为这种情况而设；如果测试允许，请换一个服务线路或另一个国家。
- 号码是以国内形式输入的。 重新检查你的表单提交的是
+375加九位数字，没有80。 - 线路繁忙。 让窗口走完，而不是一分钟后就取消，然后稍后再试。
- 你的脚本在紧凑循环中重复下单。 在两次尝试之间加入退避；对同一服务的快速重复下单很少有帮助，还可能让目标平台觉得像是滥用。
关于 +375 订单更多的失败模式，见减少 OTP 投递失败。
有长期使用的白俄罗斯号码吗？计费如何运作？
没有。OTP Route 没有自助式的白俄罗斯长期号码。如果你的团队因运营或客服场景需要，请发邮件至 [email protected] 并描述情况；能否提供取决于当地规定，不作任何承诺。专用虚拟号码是美国和加拿大的产品，每月 $1.95 起，支持接收短信、发送短信和浏览器通话。
白俄罗斯订单与其他所有线路使用同一个预付费美元钱包，没有月费，也没有套餐可选。可用银行卡或 USDT/USDC 稳定币充值；每次充值的 PDF 发票都会发到你的收件箱。开发人员可以申请沙盒账户，它返回模拟的号码和验证码，这是在真实下单之前验证集成最省钱的办法。请只把每个号码用于你自己的产品或你自己的合法账户，遵守各服务的条款，并注意 OTP Route 的可接受使用政策同样适用。当前数据见价格。
常见问题
没有当地 SIM 卡，我能测试应用的白俄罗斯注册流程吗？
可以。从 OTP Gateway 为你的服务订购一个 +375 号码，提交到注册表单，然后在控制台或通过 API 读取验证码。
OTP Route API 中白俄罗斯的国家 ID 是什么？
是 by。把它用于 GET /api/v1/prices，以及 POST /api/v1/activations 的请求体中。
我应该保留白俄罗斯号码的 80 前缀存储吗？
不应该。请以 E.164 格式存储为 +375 加九位数字，并去掉国内的 80，否则许多服务会把该号码视为无效。
如果 +375 号码一直收不到验证码，我的钱会怎样？
当 20 分钟窗口结束仍没有短信，或你取消订单时，全部费用会自动退回你的钱包。
验证短信会是什么语言？
由发送服务决定。对于白俄罗斯号码，通常是俄语或英语，取决于账户或设备的语言。
我能保留一个 +375 号码用于以后登录吗？
无法自助办理。长期专用号码只提供给美国和加拿大；白俄罗斯的号码可以发邮件至 [email protected] 询问，但不保证可用。
有没有不动用钱包资金就能测试集成的办法？
有。开发账户可应要求切换为沙盒，它会返回模拟的号码和验证码，用于端到端测试。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。