为什么危地马拉值得专门跑一轮测试？
危地马拉是中美洲人口最多的国家，对许多团队来说，它是区域性西班牙语市场上线的第一站。西班牙语是官方语言，同时也有相当比例的人口使用众多玛雅语言之一，如果你的开户引导文案或客服内容不止西班牙语，这一点就很重要。
下面三种情况反复出现：
- 区域上线，需要在真实的 +502 线路上检查手机号输入页面、西班牙语短信措辞和验证步骤（移动应用验证）。
- 侨民产品，例如居住在美国的危地马拉人所使用的汇款或通话应用，账号与家乡的号码绑定。
- 运营团队为危地马拉客户管理企业主页，而客户不希望绑定任何人的个人手机（运营团队）。
危地马拉的电话号码是什么格式？
危地马拉使用八位国内号码，并且没有长途冠码，所以没有需要去掉的开头 0。E.164 格式就是 +502 加这八位数字，写作 +502 xxxx xxxx。
这么短的长度，会让按十位北美号码设计的表单校验器出错。请添加这些测试用例：八位输入、不带加号直接输入 502 的用户，以及中间带空格或短横线的情况。请存储规范化后的 E.164 字符串，不要仅凭长度去猜号码是手机还是固话，因为两者都是同样的八位数字。
我可以通过 API 接收危地马拉短信 OTP 验证码吗？
可以。危地马拉 OTP API 使用国家 id gt，基础 URL 为 https://otproute.com/api/v1，并通过以 or_live_ 为前缀的 Bearer 密钥认证。
先用 GET /api/v1/services 找到服务 id，再用 GET /api/v1/prices?country=gt&service=<id> 查看当前报价。用 POST /api/v1/activations 创建号码，请求体为 {"service": "<id>", "country": "gt"}。应用发出短信后，你可以轮询 GET /api/v1/activations/{id}，也可以让 Webhook 端点接收 activation.sms_received。请校验 X-OTPRoute-Signature 头（对时间戳和原始请求体做 HMAC-SHA256），并拒绝过期的时间戳，具体方法见保护 OTP Webhook。开发者概览列出了各项限制：10 个密钥、5 个 Webhook 端点、每分钟 300 次请求。
目前 +502 线路上有哪些服务？
危地马拉列出了超过 1,600 个服务。当前快照中较热门的包括 WhatsApp、Facebook、TikTok、Telegram、Instagram、Google（Gmail 和 YouTube）、X（Twitter）、Uber、Amazon、Discord、LinkedIn、Signal、Netflix 以及 Microsoft 和 Outlook。库存在一天中会轮换，这就是 API 返回实时可用性，而不是固定目录的原因。
客服和运营人员有免代码的方式吗？
团队里的任何人，在用邮箱加 6 位验证码或 Google 登录注册之后，都可以通过控制台下单。选择危地马拉，挑选服务，确认显示的价格，然后把 +502 号码复制到应用中。验证码到达后会出现在同一个页面上。为 OTP Route 账号本身开启双重验证（TOTP），对共享的团队访问来说是个明智的做法。
我的 +502 验证码为什么没出现？该怎么尝试？
号码会保持 20 分钟有效，只有验证码送达时才会收费。如果窗口过期或你取消了，全部金额会自动退回钱包。
- 等完整个窗口；投递时间取决于服务和线路。
- 稍后再试，或者如果有其他服务线路，就通过它再试。
- 确认该服务是否接受虚拟号码，因为有些会拒绝。
- 不要在紧密循环里连续下新订单；两次尝试之间请退避。
危地马拉的长期号码、计费和沙盒是怎样的？
OTP Route 上没有可自助开通的危地马拉长期号码。专用号码仅限美国和加拿大，$1.95/月起。如果你需要长期的 +502 号码，请发邮件至 [email protected]；能否安排取决于当地规定，也无法保证。
付款通过一个预付美元钱包完成，没有套餐或月费，可用银行卡或 USDT/USDC 充值，每次充值都会通过邮件发送 PDF 发票。对于集成工作，可以按需把开发账号切换为沙盒，让模拟的号码和验证码免费流经你的代码。
常见问题
没有当地 SIM 卡，也能检查我们面向危地马拉的西班牙语注册流程吗？
可以。在 OTP Gateway 订购一个 gt 号码，输入到你的应用中，然后在控制台或 Webhook 中读取西班牙语验证码。
危地马拉号码需要开头的 0 吗？
不需要。危地马拉没有长途冠码，所以号码就是 +502 加八位数字。
一条 +502 验证码最低多少钱？
价格每条 $0.20 起；具体服务的价格由 GET /api/v1/prices 返回，并在你确认前显示。
如果验证短信始终没来，我会被收费吗？
不会。20 分钟窗口内没有送达验证码，或者取消之后，全部金额会退回钱包。
OTP Route 能为我的团队长期保留同一个 +502 号码吗？
无法通过自助方式。OTP Gateway 号码只处理一条验证码，长期号码仅限美国和加拿大，所以关于危地马拉请咨询 [email protected]。
使用这些号码要遵守哪些规则？
各服务自己的条款，加上 OTP Route 的《可接受使用政策》。只把号码用于测试或运营你自己的合法产品和企业账号。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。