上线前检查清单:申请 +1 345 号码之前应该准备什么?
把这份清单走一遍,第一次开曼激活通常就会很平稳:
- 账户与安全。 用电子邮箱和 6 位邮箱验证码(或 Google 登录)注册,然后为所有能动用钱包资金的人开启 TOTP 双重验证。
- 钱包已充值。 通过银行卡或 USDT/USDC 为预付美元钱包充值。无需选择套餐,也没有月费。
- API 密钥。 在开发者控制台创建;它以
or_live_开头,放在 Bearer 请求头中。每个账户最多可持有 10 把密钥。 - Webhook 端点。 注册一个 URL,并把它的密钥保存在你的处理程序能读取的位置。每个账户最多五个端点。
- 手机号解析已配置。 确保你的号码库把区号 345 解析为开曼群岛,而不是把所有
+1号码默认当作美国。 - 如需演练,请使用沙盒。 请联系支持团队把开发账户切换为沙盒模式,这样模拟的号码和验证码就能在不动用钱包资金的情况下测试你的集成。
API 参考文档列出了响应中会出现的所有字段。
为什么开曼号码会难倒那些假定 +1 就是美国的代码?
开曼群岛属于北美编号计划,因此与美国、加拿大以及一长串加勒比地区共用国家代码 1。识别开曼号码的是区号 345。完整号码在国家代码之后有十位数字,本地写作 (345) NXX-XXXX,以 E.164 存储为 +1345 加七位数字。
对工程师而言有三点实际影响:
- 区域检测必须看区号。仅凭
+1前缀推断国家的注册表单,会把开曼客户标为美国客户,还可能选错时区、币种或同意声明文本。 - 在 NANP 中,开头的 1 同时也是长途前缀,所以用户有时会输入
1 345...或直接输入345...。保存前请把这三种写法都规范化为 E.164 字符串。 - 存储号码时不要带空格、连字符或括号,只在显示时才格式化。
英语是官方语言,所以这个市场的验证码通常以英语送达。不过具体措辞由发送短信的服务决定,而不是线路。
哪些服务可以向开曼群岛验证号码路由验证码?
国家 ky 的实时快照目前包括 WhatsApp、Telegram、Google(Gmail 和 YouTube)、Microsoft 和 Outlook、LinkedIn、Amazon、Airbnb、Uber、Signal、Discord、ChatGPT(OpenAI)、Netflix 和 eBay。算上长尾服务,这条线路覆盖 600 多项服务,而且列表会在一天中变化,所以可用性始终应从 API 读取,而不是写死。
团队通常因为群岛是重要的离岸金融中心和繁忙的旅游目的地而需要 +1 345 号码来测试。基金管理人、保险公司、旅行平台和房地产企业都会引入本地客户,他们的产品团队希望看到注册流程在开曼居民眼中的实际表现。金融科技开户笔记更深入地介绍了这种模式。
分步说明:开曼群岛 OTP API 的调用顺序是怎样的?
所有调用都发往 https://otproute.com/api/v1,带上你的 Bearer 密钥,限额为每分钟 300 次请求。
- 调用一次
GET /api/v1/services,缓存你的测试套件需要的服务 ID。 - 调用
GET /api/v1/prices?country=ky&service=<id>读取实时价格,并确认该组合当前可用。 - 发送
POST /api/v1/activations,请求体形如{"service": "<id>", "country": "ky"}。响应中包含激活 ID 和 +1 345 号码。 - 在被测应用中输入该号码,并触发它的短信步骤。
- 在你的 Webhook 上等待
activation.sms_received。先检查X-OTPRoute-Signature请求头:用端点密钥计算<t>.<raw body>的 HMAC-SHA256,与v1比较,并拒绝过期的时间戳。 - 没有 Webhook 时,以适度的间隔轮询
GET /api/v1/activations/{id},直到验证码出现或窗口关闭。 - 如果测试中止,调用
POST /api/v1/activations/{id}/cancel,冻结的金额会退回钱包。
HMAC Webhook 指南逐行讲解了签名检查。
喜欢用控制台的同事,分步操作如下
客服人员和客户经理完全不需要接触 API:
- 在控制台打开 OTP Gateway 页面。
- 选择开曼群岛作为国家,再选择你要验证的服务。
- 下单前查看显示的价格并确认。
- 将号码复制到应用中,请求验证码,并保持激活页面打开;短信到达时会显示在那里。
20 分钟的窗口和退款规则,与通过 API 使用时完全相同。
故障排查:+1 345 号码收不到验证码怎么办?
没有响应的激活不会产生任何费用。如果 20 分钟用完之前没有收到短信,或者你取消了,全部金额会自动退回钱包。再次下单之前:
- 让窗口走完。 投递时间取决于服务和线路,所以验证码来得慢并不一定是失败。
- 查看服务的政策。 有些服务直接拒绝虚拟号码,这正是退款机制存在的原因。
- 稍后重试或更换线路。 库存会在一天中变化;一小时后再试一次,或者换一个邻近的加勒比国家,表现可能不同。
- 避免紧凑循环。 每隔几秒就取消并重新下单的脚本会耗尽你的频率限制,而且很少有帮助。
投递失败排查手册有更多诊断方法。请只把每个号码用于你自己的产品或你自己的企业账户,遵守每个服务的条款,并记住 OTP Route 的《可接受使用政策》同样适用。
我能长期保留开曼号码吗?费用如何处理?
开曼群岛没有可自助购买的长期号码。共用 +1 国家代码也改变不了这一点:专属号码仅限美国和加拿大,每月 $1.95 起,支持接收短信、发送短信和浏览器拨打电话。如果你的团队需要一个固定的 345 号码,请发邮件至 [email protected];能否提供取决于当地规定,不作保证。
其他一切都使用同一个预付美元钱包。通过银行卡或 USDT/USDC 充值,每笔都会通过邮件收到 PDF 发票,价格页面说明了按量付费的模式。
常见问题
没有本地 SIM,我能测试应用的开曼群岛注册流程吗?
可以。通过 OTP Gateway 申请一个 +1 345 号码,填入你的应用,然后在控制台或通过 API 读取验证码。每个验证码 $0.20 起,而且只有验证码到达时才付费。
API 中开曼群岛使用什么国家 ID?
ID 是 ky。调用 GET /api/v1/prices 或 POST /api/v1/activations 时,把它作为 country 值传入。
我应该如何在数据库中存储开曼的手机号?
以 E.164 格式存储:+1345 加七位用户号码,不含空格或标点。请根据 345 区号而不是 +1 前缀来识别地区。
+1 345 号码算作专属号码里的美国号码吗?
不算。专属号码仅面向美国和加拿大销售,所以开曼号码只能作为一次性验证码的 OTP Gateway 激活使用。
如果短信一直没到,我的钱会怎样?
激活会保持 20 分钟。如果在此期间没有收到验证码,或者你提前取消,全部金额会自动退回你的钱包。
我能在 CI 中运行开曼 OTP 测试而不花钱包里的钱吗?
请联系支持团队把开发账户切换为沙盒。它会返回模拟的号码和验证码,让你的流水线可以零成本演练完整的激活和 Webhook 流程。
OTP Route 覆盖多少项开曼服务?
在最新快照中为 600 多项。由于库存会在一天中变化,请查询 GET /api/v1/services 和价格接口来获取实时可用性。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。