订购 +599 号码之前，检查清单上应该有什么？
海岛市场值得稍作准备，因为线路的可用情况在一天之中会变化，匆忙的测试只会浪费时间。在发出第一个请求之前，请逐项确认：
- 开发者控制台中的 API 密钥。密钥以
or_live_开头；一个账户最多可持有 10 个，所以请为 CI 和预发布环境各配一个。 - 已充值的美元钱包，或者按需申请切换为沙盒的开发账户，如果你只想演练集成。
- 正确的 id。 库拉索在 API 中是
cw；服务 id 来自GET /api/v1/services。 - 已保存密钥的 webhook 端点，或者间隔合理的轮询循环。每个账户最多允许 5 个端点。
- +599 号码的存储规则（见下文），让测试数据与生产数据一致。
- 针对空结果的预案：窗口过期仍没有验证码时，你的测试该怎么做。
库拉索验证号码线路涵盖哪些服务？
库拉索的实时快照列出超过 400 项服务。常用的包括 Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X（Twitter）、ChatGPT（OpenAI）、Microsoft & Outlook、Amazon、Discord、LinkedIn、Signal、Netflix、Uber 和 Airbnb。旅行和通讯类的名字是库拉索团队最先想到的，因为酒店和面向游客的产品带来了该岛大量的数字注册。
请把这份列表当作起点，而不是承诺。库存在一天之中会变化，这正是 API 在每次价格查询时都返回可用情况的原因。
分步说明：调用库拉索 OTP API
每个调用都发往 https://otproute.com/api/v1，携带你的 Bearer 密钥，上限为每分钟 300 次请求。
- 读取
GET /api/v1/prices?country=cw&service=<id>，确认线路已开通并查看该组合的当前价格。 - 用
POST /api/v1/activations创建订单，发送{"service": "telegram", "country": "cw"}或你需要的任何服务 id。响应包含激活 id 和 +599 号码。 - 把该号码输入你正在测试的注册或登录界面。
- 在 webhook 上等待
activation.sms_received，或以平稳的间隔轮询GET /api/v1/activations/{id}。 - 如果测试被放弃，调用
POST /api/v1/activations/{id}/cancel，钱包会立刻得到退款。
在信任任何 webhook 之前，请检查 X-OTPRoute-Signature 头：用端点密钥对 "<t>.<raw body>" 计算 HMAC-SHA256，并拒绝过期的时间戳。Webhook 签名指南有更深入的讲解。
+599 号码应如何存储和规范化？
库拉索与博奈尔、圣尤斯特歇斯和萨巴共用 +599 国家代码，库拉索的用户号码在该代码之后紧跟一个 9。这个开头的 9 是号码的一部分，而不是冠码，所以去掉它的规范化函数会破坏记录。请保存完整的 E.164 字符串（+5999 加其余数字），不含空格，只在显示时添加格式。
还值得检查你的电话输入控件是否把库拉索列为独立条目，而不是并入通用的荷属安的列斯选项，较旧的库仍然是这样做的。
关于语言：帕皮阿门托语、荷兰语和英语都是官方语言，大多数全球服务以英语发送验证码，或遵循账户设置的语言。如果你的产品本地化为荷兰语或帕皮阿门托语，请每种语言至少测试一遍，以便看到真实的模板，而不是回退内容。团队通常在此测试的场景包括：进入荷属加勒比市场、服务从海外预订的游客，或从岛上开展区域运营。
不写代码的人该走控制台的哪条路径？
客服人员和产品经理无需任何脚本就能完成同样的事情：
- 用邮箱和 6 位验证码，或 Google 登录，创建账户，并开启 TOTP 双因素认证。
- 为钱包充值。
- 打开 OTP Gateway，选择服务，再选择库拉索；确认前会显示价格。
- 把 +599 号码复制到应用中，并留意激活卡片，直到验证码出现。
适用与 API 相同的 20 分钟窗口和退款规则。
故障排除：库拉索的验证码一直没有出现
激活没有动静是偶尔会发生的正常情况，而且不会产生费用，因为窗口结束或你取消时，金额会退回钱包。
- 让窗口走完。 有些服务重发较慢；在第二分钟取消，会丢掉一条可能仍会到达的验证码。
- 检查目标服务对虚拟号码的态度。 有些会拒绝，这正是设立退款的原因。
- 稍后重试，或尝试另一条国家线路，如果测试并不特别依赖库拉索号码。
- 避免在紧凑的循环中重复下单。 在两次尝试之间退避，以免为同一个测试叠加并行的激活。
QA 测试方案页面展示了团队如何把这些重试逻辑构建到自动化测试套件中。
库拉索项目的长期号码、钱包与计费
库拉索没有自助开通的长期号码。如果你需要保留数月的号码，请发邮件至 [email protected]，团队会核实当地规定允许什么；不作任何承诺。专属号码是面向美国和加拿大的产品，每月 $1.95 起，详见虚拟号码页面。
库拉索的激活从一个预付的美元钱包中扣款，没有月费，也无需选择套餐。银行卡和 USDT/USDC 都可以用于充值，每次充值都会生成一份通过邮件发送的 PDF 发票，供你库拉索项目的账目使用。当前价格见定价页面。请只把 OTP Route 用于你自己的产品和合法账户，遵守各服务的条款，并请注意 OTP Route 的《可接受使用政策》适用。
常见问题
不购买当地 SIM 卡，也能测试库拉索的注册流程吗？
可以。从 OTP Gateway 为被测服务订购一个 +599 号码，然后在控制台或通过 API 读取验证码，岛上无需任何 SIM 卡或手机。
OTP Route 中库拉索使用哪个国家 id？
库拉索是 cw。在每一次价格查询和下单中，请把 cw 与 GET /api/v1/services 列出的服务 id 搭配使用。
+599 之后的 9 是需要去掉的冠码吗？
不是。对库拉索而言，9 是用户号码的一部分，所以请在保存的 E.164 值中保留它。
库拉索的激活过期而没有验证码时，我会被收费吗？
不会。如果 20 分钟内没有收到短信，或者你先取消，全部金额会自动退回你的钱包。
我能保留一个库拉索号码用于下个月的重复登录吗？
无法自助开通。长期专属号码仅面向美国和加拿大销售；库拉索可以发邮件给支持团队咨询，但不保证可以提供。
如何在花费钱包资金之前搭建集成？
请通过支持团队为开发账户申请沙盒模式。它返回模拟的号码和验证码，让完整的 API 和 webhook 路径可以端到端地演练。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。