Zalo 验证码 API 的流程是怎样的？
服务 id 是 zalo。请求发往 https://otproute.com/api/v1，使用在开发者控制台签发、前缀为 or_live_ 的 Bearer 密钥。
- 通过
GET /api/v1/countries获取国家 id；例如越南是vn。 - 用
GET /api/v1/prices?country=vn&service=zalo查看实时价格和可用情况。 - 创建激活：
POST /api/v1/activations，请求体为{"service": "zalo", "country": "vn"}。保存 activation id 和返回的号码。 - 把号码填入你自己掌控的测试账号的 Zalo 手机号界面。
- 通过 webhook 或轮询获取验证码，也可以用
POST /api/v1/activations/{id}/cancel结束订单。
在测试套件开始时用 GET /api/v1/balance 检查一次余额，可以避免运行到一半才出问题。完整的请求格式请见 API 文档。
为 Zalo 验证码搭建 webhook 接收端
在开发者控制台注册一个端点，并订阅 activation.sms_received、activation.expired 和 activation.cancelled。每个请求都带有格式为 t=<unix>,v1=<hex> 的 X-OTPRoute-Signature 头；使用端点密钥对 <t>.<raw body> 计算 HMAC-SHA256，用恒定时间比较，并拒绝过旧的时间戳。
以 activation id 为键保存结果，让处理程序保持幂等。如果同一事件被投递两次，第二次写入应当不产生任何效果。没有公网端点的团队可以改为轮询 GET /api/v1/activations/{id}；每分钟 300 次请求的上限，足以让多个并行测试以较短的间隔轮询。
Zalo 什么时候会要求输入手机号？
Zalo 是一款越南的即时通讯与社交应用，手机号是账号的主要标识。通常在创建账号、在新设备上登录以及找回访问权限时会请求验证码。具体的提示由 Zalo 决定，并且可能发生变化，因此测试计划应覆盖每个界面，而不是假定一成不变的流程。
对 QA 团队来说，这一点很重要：围绕 Zalo 构建的消息集成、小程序或客服渠道，往往需要先有一个已验证的全新测试账号，其他场景才能运行。
在 OTP Route 上，哪些国家可以接收 Zalo 验证码？
Zalo 线路在 198 个国家上线，包括越南、美国、日本、韩国、台湾、澳大利亚、加拿大、柬埔寨、老挝、泰国、马来西亚、新加坡、德国、法国和英国。
请选择与被测账号相符的国家。越南市场的上线测试需要 +84 号码才能还原当地用户所见；而服务海外越南社群的团队，则可能需要这些客户所在国家的号码。国家还会影响价格和可用性，所以建议先查看价格接口。
Zalo 短信验证测试的控制台步骤
项目里并不是每个人都会写代码。在控制台中，选择 Zalo 作为服务，选定国家，确认显示的价格并下单。把号码复制到 Zalo 中；短信送达后，验证码会显示在订单旁边。在同一界面取消订单会全额退款。注册控制台账号只需要邮箱地址和 6 位邮箱验证码（或 Google 登录），并可启用 TOTP 双重验证来保护团队登录。
Zalo 验证码为什么可能收不到？
送达情况取决于服务和线路，所以没有固定的等待时间。Zalo 也可能拒绝部分虚拟号码，这正是设置退款的原因。如果什么都没出现：
- 让订单保持开启直到 20 分钟窗口结束，或者主动取消；无论哪种，钱包都会收回款项。
- 稍后再试，或换一个适合该测试的国家。
- 不要连续不断地重复下单；自动化任务里请加入退避机制。
- 确认测试账号本身没有在 Zalo 一侧被封锁或限流。
Zalo 测试账号应该改用 Dedicated Number 吗？
OTP Gateway 号码只处理一条验证码。如果某个预发布或客服账号下个月还要再次登录，Dedicated Number 更合适：这是一条美国或加拿大的号码，价格从 $1.95/month 起，续费期间归你持有，入站短信显示在控制台，并通过 number.sms_received webhook 推送。详情见虚拟号码。
无论选哪种方式都请负责任地使用。遵守 Zalo 的条款，每个账号对应一位真实的个人或企业，并且只把 OTP Route 用于测试和运营你自己的合法账号与产品。Zalo 是其所有者的商标，OTP Route 与其没有关联。
常见问题
OTP Route API 中 Zalo 的服务 id 是什么？
是 zalo，需要和国家 id 一起放在 POST /api/v1/activations 的请求体中。
可以在越南以外的号码上接收 Zalo 验证码吗？
可以。Zalo 线路在 198 个国家上线，各国的实时可用情况由价格接口返回。
如果 Zalo 拒绝了虚拟号码，我会被扣费吗？
不会。如果 20 分钟内号码没有收到验证码，或者你取消了订单，全额款项会退回钱包。
适合长期使用的 Zalo 账号可以用虚拟号码吗？
一次性号码不适合。需要反复登录的话，更稳妥的是续费期间归你持有的美国或加拿大 Dedicated Number。
Zalo 短信验证测试怎么付费？
为预付的美元钱包充值，可使用银行卡或 USDT/USDC；没有月费，每次充值都有 PDF 发票。
可以不花钱试用 Zalo 集成吗？
可以。技术支持把开发账号切换到沙盒模式后，Zalo 订单会返回模拟号码和验证码，这样在真正花钱之前就能验证 webhook 和轮询代码。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。