为什么文莱需要单独做验证测试？
文莱是位于婆罗洲岛上的一个小型、高度互联的苏丹国，其用户使用的应用与马来西亚和印度尼西亚的邻居相同。这种重叠容易让团队把它当作事后才想到的市场，但文莱手机号码在表单和校验器中的表现与马来西亚号码不同，所以它值得拥有自己的测试用例。
马来语是官方语言，英语在商业和政府中很常见，所以区域性应用发来的短信验证码可能是其中任一种，取决于账户创建时的语言区域设置。团队通常在以下情况选用文莱线路：
- 把文莱加入东盟上线计划，需要证明注册能端到端走通；
- 对马来语消息模板和应用内字符串做本地化 QA；
- 运营区域性业务账户，希望员工的个人号码不出现在上面。
+673 号码应该如何存储和规范化？
文莱号码使用封闭的七位编号方案，没有中继前缀，所以没有需要去掉的前导零。E.164 形式就是 +673 加七位全国号码，算上国家代码共十位数字。
这么短的长度正是 bug 藏身之处。针对马来西亚或印度尼西亚调整的手机号字段，往往强制了最小长度，会悄悄拒绝有效的文莱输入。这条线路的良好习惯：
- 以带加号的 E.164 字符串存储号码，绝不要存成整数。
- 接受不带加号输入的
673，并在保存时改写。 - 校验前去掉空格和连字符，然后按国家检查长度，而不是用一条全局规则。
一个用于测试的一次性 +673 号码，是确认你的校验器、短信模板和登录页面三者一致的最快办法。
现在可以在文莱线路上验证哪些应用？
文莱的实时快照列出了超过 1,400 个服务。团队问得最多的包括 WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、WeChat、LINE、Microsoft & Outlook、Discord、ChatGPT (OpenAI)，以及区域性电商平台 Shopee、Lazada 和 Tokopedia。
库存在一天中会变化，所以请把任何列表都当作起点，每次运行前向 API 查询。某个组合的价格会实时返回，并在你确认订单之前显示在控制台中。
文莱 OTP API 的调用顺序是什么样的？
所有调用都发往 https://otproute.com/api/v1，使用在开发者控制台创建、以 or_live_ 开头的 Bearer 密钥。一个账户最多可持有 10 个密钥，便于给 CI、预发布环境和客服工具分别配置独立的凭据。
- 读取一次
GET /api/v1/services和GET /api/v1/countries并缓存；文莱的国家 ID 是bn。 - 查询
GET /api/v1/prices?country=bn&service=<id>确认可用性和当前价格。 - 用
POST /api/v1/activations创建订单，请求体类似{"service": "shopee", "country": "bn"}。 - 把返回的 +673 号码输入被测流程。
- 通过
activation.sms_receivedwebhook 或轮询GET /api/v1/activations/{id}接收验证码。
Webhook 投递带有 X-OTPRoute-Signature: t=<unix>,v1=<hex>。请用端点密钥对 <t>.<raw body> 重新计算 HMAC-SHA256，以恒定时间比较，并丢弃时间戳过期的请求；HMAC 指南有详细讲解。每分钟 300 个请求的限制，为并行任务的轮询留足了空间，完整的数据结构见 API 文档。
非开发人员能在控制台订购文莱号码吗？
可以。运营人员和代理机构的客户经理往往更喜欢点鼠标而不是写脚本：
- 登录并打开 OTP Gateway。
- 选择文莱作为国家并挑选服务。
- 查看显示的价格，然后确认。
- 把 +673 号码复制到你要验证的应用里。
- 观察激活；验证码到达后会出现在同一屏幕上。
同一次激活也会触发你的 webhook，所以开发人员和客服负责人可以从两个地方跟进同一个订单。
+673 验证码一直没出现，应该怎么做？
每次激活保持开启 20 分钟。如果这段时间内没有短信到达，或者你用 POST /api/v1/activations/{id}/cancel 取消，全部金额会自动退回你的钱包；只有验证码真正送达时才会计费。
如果验证码缺失，先让窗口跑完，因为有些服务发送得较晚。然后稍后再试，或通过另一条线路订购同一服务。确认目标应用到底接受不接受虚拟号码，因为有些会拒绝；同时避免在紧凑的循环里重复下单，那往往会触发发送方自己的速率限制。更多做法见我们关于降低 OTP 送达失败率的文章。请始终遵守各服务的条款；OTP Route 的《可接受使用政策》适用于每一笔订单。
有长期的文莱号码吗？账单如何计算？
文莱没有自助的长期号码。续订期间可以一直保留的专用号码是仅限美国和加拿大的产品，每月 $1.95 起，详见虚拟号码页面。如果你的团队确实需要持续使用的文莱号码，请发邮件至 [email protected]；是否可以安排取决于当地规定，不作承诺。
+673 激活的花费从同一个预付美元钱包中扣除，按量付费，没有订阅或套餐档位。文莱项目与其他任何线路一样从中扣款：用银行卡、USDT 或 USDC 充值，并保留每次充值后通过邮件发送的 PDF 发票作为记录。做集成工作时，可按要求把开发账户切换为沙盒，让你的 QA 流水线在不动用钱包资金的情况下收到模拟的号码和验证码。
常见问题
不买本地 SIM 卡，也能检查我的应用的文莱注册流程吗？
可以。在 OTP Gateway 为你正在测试的服务订购一个 +673 号码，然后在控制台或通过 API 读取验证码。
文莱在 OTP Route 中的国家 ID 是什么？
是 bn。在价格查询和激活请求体中把 bn 作为国家传入。
文莱电话号码有需要去掉的前导零吗？
没有。文莱没有中继前缀，所以 E.164 形式就是 +673 加七位数字。
验证短信会是马来语还是英语？
这取决于应用和账户的语言区域设置。区域性应用通常发送英文，账户按此设置时有些也会发送马来语。
如果 Shopee 或 WhatsApp 的验证码没到，我会被扣费吗？
不会。20 分钟内没有短信到达该号码，或者你取消了，全部金额都会退回钱包。
文莱线路支持多少个服务？
当前快照显示超过 1,400 个。请调用 GET /api/v1/services 或查看控制台了解实时可用情况。
我能保留文莱号码用于以后的登录吗？
自助方式不行。长期专用号码只在美国和加拿大提供，关于文莱可以发邮件向支持团队咨询。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。