四个 API 调用即可接收哥伦比亚短信 OTP
哥伦比亚 OTP API 的集成只需要少量请求。首先用 GET /api/v1/prices?country=co&service=whatsapp 确认线路已开通，把其中的服务 id 换成你要测试的服务；响应会返回该组合的实时价格。接着用 POST /api/v1/activations 创建订单，JSON 请求体中指定服务，并以 co 作为国家。你会得到一个激活 id 和一个 +57 号码，把它填入被测应用即可。
然后等待短信。多数团队会注册一个 webhook 端点并监听 activation.sms_received，也有人以较低频率调用 GET /api/v1/activations/{id}。最后做好收尾：如果测试改了方向，POST /api/v1/activations/{id}/cancel 会释放预留的资金。每个请求的详细说明见开发者文档。
目前哪些哥伦比亚常用应用在线路上？
在最新快照中，哥伦比亚的 OTP 路由涵盖超过 1,900 项服务。常被请求的包括 WhatsApp、Telegram、Google（Gmail 和 YouTube）、Instagram、Facebook、TikTok、Uber、Microsoft & Outlook、Amazon、Discord、LinkedIn、Signal 和 Netflix。容量在一天之中会变化，所以定时测试应当通过 GET /api/v1/services 和价格接口查询当前开放的内容，而不是依赖硬编码的列表。
按 E.164 存储 +57 手机号的格式
哥伦比亚手机号在国家代码之后有十位数字，并以 3 开头，E.164 形式为 +57 3XX XXX XXXX。国内拨打时不加前导零，所以规范化很简单：去掉空格、短横线和括号，保留加号和 57，保存为一个标准字符串。在客户端检查开头的 3，可以让粘贴了固定电话号码的测试人员看到清晰的提示，而不是在短信环节悄无声息地失败。
是什么把 QA 团队带到哥伦比亚市场？
哥伦比亚是规模较大的西班牙语市场之一，许多拉丁美洲的产品上线都从这里或附近开始。验证短信通常以西班牙语送达，所以本地化检查应当确认你自己的模板读起来自然、带重音符号的字符在编码后依然完好，并且数字在较长的句子里仍然容易辨认。出行、配送、支付和电商类产品在该地区都依赖手机号校验，这也是 +57 测试号码总会出现在发布检查清单上的原因。我们的 QA 测试 页面汇集了适用于任何短信验证 API 的做法。
+57 验证码迟迟不来，怎么办？
每次激活保持 20 分钟有效。如果窗口关闭时仍没有短信，或者你先取消，全部金额会自动退回你的钱包，你的端点也会收到 activation.expired 或 activation.cancelled。再次尝试之前：
- 检查你测试的应用是否接受虚拟号码；
- 让当前窗口自然结束，而不是叠加新订单；
- 重试之间留出间隔，不要在紧凑的循环中下单；
- 换一个稍后的时段，或为同一服务尝试其他线路。
文章 减少 OTP 投递失败 解释了每一步背后的原因。
能把哥伦比亚号码保留几个月吗？
无法自助开通。Dedicated Virtual Numbers 包含收发短信和浏览器通话功能，仅面向美国和加拿大销售，每月 $1.95 起。控制台中无法购买长期的 +57 号码。如果你的业务需要，请写信至 [email protected]；是否能够安排取决于当地规定，无法事先承诺。
如何为哥伦比亚验证付费
OTP Route 采用预付美元钱包，没有月费，也无需选择套餐。可以用银行卡或 USDT/USDC 稳定币充值，每次充值后财务会收到邮件发送的 PDF 发票。哥伦比亚线路每条验证码 $0.20 起，具体价格因服务而异，确认前会显示确切金额。进行集成开发时，可以请支持团队把开发账户切换到沙盒，用模拟的号码和验证码演练整个流程，而无需动用钱包资金。当前价格见定价页面。
常见问题
没有当地 SIM 卡，也能测试我的应用的哥伦比亚注册流程吗？
可以。为你要检查的服务订购一个 +57 号码，填入注册表单，然后在控制台或 webhook 中读取验证码。无需寄送或激活任何实物。
如何在控制台订购哥伦比亚验证号码？
登录后打开 OTP Gateway，选择服务和哥伦比亚，查看价格并确认。号码会显示在屏幕上，短信到达后验证码就出现在旁边。
API 中哥伦比亚使用哪个国家 id？
在 country 字段和价格查询中使用 co。服务 id 来自 GET /api/v1/services，例如 telegram 或 uber。
如果 +57 号码始终没收到验证码，我需要付费吗？
不需要。20 分钟窗口结束仍没有短信，或者你取消时，全部费用会自动退回你的钱包。
哥伦比亚的验证短信会使用什么语言？
取决于发送方，不过哥伦比亚用户多半看到西班牙语模板。请提取数字，而不要匹配固定措辞，因为模板可能在不通知的情况下改变。
我的 CI 流水线可以自行接收哥伦比亚短信 OTP 吗？
可以。在流水线中创建激活，等待 webhook 或轮询该激活，再把验证码送入测试。我们的 CI 中的 OTP 测试 一文介绍了超时与清理。
如何确认某个 webhook 确实来自 OTP Route？
每个请求都带有 X-OTPRoute-Signature，内含时间戳，以及用你的端点密钥对“时间戳、一个点和原始请求体”计算的 HMAC-SHA256。请重新计算并以常量时间比较，同时丢弃过期的时间戳。
使用 +57 号码验证的内容有限制吗？
有。号码只能用于你自己的产品和合法的业务账户，请遵守各服务的条款，并记住 OTP Route 的《可接受使用政策》适用于每一笔订单。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。