波多黎各项目应该用 OTP Gateway 还是专属号码？
先看号码需要存在多久。OTP Gateway 会分配一个只用于一条验证码的 +1 787 号码，适合注册测试、本地化检查，或只验证一次就结束的 CI 任务。专属号码是你长期保留的线路，适合下周还要再次登录的预发布账户，或共用的客服收件线路。
对波多黎各来说，选择其实已经定了。虽然该岛是美国领地，但其号码不在自助购买的专属号码库存之内；该产品仅覆盖美国和加拿大，每月 $1.95 起。如果循环使用的账户可以接受美国本土号码，虚拟号码 页面介绍了可选方案。如果你确实需要波多黎各的长期号码，请发邮件至 [email protected]；能否安排取决于当地规定，并不能保证。
哪些波多黎各 OTP API 调用用来创建和读取激活？
API 位于 https://otproute.com/api/v1，需要以 or_live_ 为前缀的 Bearer 密钥。波多黎各的国家 id 是 pr。
- 用
GET /api/v1/services和GET /api/v1/countries获取 id，并按部署缓存。 - 先询价：
GET /api/v1/prices?country=pr&service=<id>返回当前价格，并显示线路是否开放。 - 用
POST /api/v1/activations下单，请求体为{"service": "<id>", "country": "pr"}。 - 把返回的号码填入被测流程。
- 通过 Webhook 上的
activation.sms_received接收验证码，或轮询GET /api/v1/activations/{id}。 - 如果任务提前结束，用
POST /api/v1/activations/{id}/cancel取消。
Webhook 请求带有 X-OTPRoute-Signature: t=<unix>,v1=<hex>。请用端点密钥重新计算 <t>.<raw body> 的 HMAC-SHA256，以恒定时间比较，拒绝过旧的时间戳，并对已处理过的激活 id 忽略重复事件。每个账户有 10 个密钥、5 个 Webhook 端点，每分钟 300 次请求。OTP API 集成指南 有更深入的说明。
+1 787 和 +1 939 号码在表单中有什么棘手之处？
波多黎各属于北美编号计划，因此其号码看起来和普通美国号码一样：国家代码 1、三位区号（787 或叠加区号 939）加七位数字，E.164 写法是 +1787 或 +1939 后接七位数字。
这种相似性会引发真实的缺陷。有些应用把波多黎各列为独立国家（ISO 代码 PR），有些则并入美国，地址表单还可能要求把 PR 当作州值。请确认你的国家选择器、电话校验器和地址字段彼此一致，并且选择了波多黎各的用户绝不会被提示其 +1 号码无效。请以 E.164 存储号码，并根据区号而不是开头的 +1 来判断地区。
哪些服务可以接收波多黎各短信 OTP 验证码？
波多黎各线路目前支持超过 900 个服务。常见的发送方包括 WhatsApp、Uber、Google（Gmail 和 YouTube）、Facebook、Instagram、TikTok、X (Twitter)、Amazon、ChatGPT (OpenAI)、Microsoft 和 Outlook、LinkedIn、Discord、Airbnb、Netflix 和 Telegram。可用情况在一天中会变化，所以下单时应以 API 的返回结果为准，而不是任何列表。
不写代码的话，在控制台打开 OTP Gateway，选择波多黎各和一个服务，确认显示的价格后下单。波多黎各验证号码会连同倒计时一起出现，短信到达后验证码会显示在它旁边。
如果 20 分钟内没有出现验证码怎么办？
每次激活持续 20 分钟，只有验证码到达才会扣费。如果窗口到期仍无内容，或者你主动取消，全额金额会自动退回钱包。
如果波多黎各的验证码迟迟不来：
- 在把测试标记为失败之前，给激活留足完整的窗口期。
- 稍后再试，或选择另一个服务线路。
- 确认该服务接受虚拟号码；有些服务会拒绝，退款机制正是为此准备的。
- 不要在紧凑的循环里连续下新订单；在两次尝试之间加入指数退避。
更多通用做法请阅读 降低 OTP 投递失败率。
团队为什么要为波多黎各验证西班牙语和英语流程？
西班牙语和英语都是官方语言，而大多数居民日常使用的是西班牙语。这使波多黎各成为检查双语注册流程的实用场所：应用设为西班牙语时，验证短信是否以西班牙语到达？验证码输入页面能否正确处理带重音符的文案？用户在流程中途切换语言时，是否发出了正确的模板？该岛使用美元，许多美国公司已经在服务当地，因此把美国业务延伸到此的支付应用、外卖平台、交易市场和银行，常常需要一个 +1 787 号码来做测试。请在你自己掌控的账户上进行这些检查，遵守各服务的条款，并遵循 OTP Route 的《可接受使用政策》。如需自动化，请参阅 CI/CD 测试。
波多黎各测试的钱包和沙盒如何运作？
没有订阅。一个预付美元钱包为所有订单付款，没有月费，也无需选择套餐。可通过银行卡或 USDT/USDC 充值，每次充值和购买号码都会收到 PDF 发票邮件。正式上线前，可申请把开发账户切换为沙盒，它会返回模拟的号码和验证码，让你无需花费资金就能演练完整的 OTP 路由流程。准备好之后，创建账户，使用邮箱加 6 位验证码或 Google 登录，并为团队启用 TOTP 双重验证。
常见问题
没有本地 SIM 卡，能测试波多黎各的注册流程吗？
可以。从 OTP Gateway 订购一个 +1 787 号码，填入你的应用，然后在控制台或通过短信验证 API 和 Webhook 获取验证码。
API 里把波多黎各视为美国吗？
不是。它有自己的国家 id pr，在价格查询和激活请求中使用它，而不是美国的 id。
我能购买 +1 787 专属号码吗？
不能通过控制台购买。自助购买的专属号码仅覆盖美国和加拿大；如需波多黎各的线路，请发邮件至 [email protected] 咨询。
验证短信会是西班牙语吗？
这取决于发送方，通常也取决于应用的语言设置。如果你的产品支持两种语言，请同时测试西班牙语和英语区域设置。
波多黎各号码可能出现哪些区号？
波多黎各使用 787 和 939。无论收到哪一个，都请以 E.164 格式存储，以保证记录一致。
波多黎各验证码要多少钱？
每条 $0.20 起。各服务的具体价格来自 GET /api/v1/prices 和控制台，验证码没有到达则不会扣费。
我可以并行运行多少个测试？
账户允许每分钟 300 次请求和 10 个密钥。这部分额度大多消耗在轮询上，所以使用 Webhook 能为并行任务留出更多余量。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。