如何用代码申请 +595 号码？
先在开发者控制台创建一个 Bearer 密钥；密钥以 or_live_ 开头，最多可持有 10 个，便于为预发布环境和 CI 分别使用不同的密钥。所有调用都发往 https://otproute.com/api/v1。
- 缓存
GET /api/v1/services和GET /api/v1/countries的目录。巴拉圭显示为py。 - 每次下单前，读取
GET /api/v1/prices?country=py&service=<id>。价格和可用性是实时值，不是常量。 - 用
POST /api/v1/activations和{"service": "whatsapp", "country": "py"}下单。保留响应中的 activation id。 - 在被测流程中提交该号码。
- 等待 Webhook，或检查
GET /api/v1/activations/{id}；如果测试提前停止，调用POST /api/v1/activations/{id}/cancel。
GET /api/v1/balance 适合作为流水线的前置检查步骤，这样钱包为空时任务会明确报错，而不是超时。集成指南用更多背景介绍了同样的调用。
Webhook 处理程序应该如何处理巴拉圭的验证码？
消息到达时，您的端点会收到 activation.sms_received，窗口空着结束时收到 activation.expired，取消后收到 activation.cancelled。每个事件都与 activation id 绑定。
- 先验证。 把
X-OTPRoute-Signature拆分为t和v1，用端点密钥对时间戳、一个点号和原始请求体计算 HMAC-SHA256，并以恒定时间比较。 - 拒绝过期请求。 时间戳与您的时钟相差很大，意味着重放攻击或服务器时钟严重偏差。
- 保持幂等。 保存 activation id 并忽略重复，这样重试的投递不会把同一个验证码重复处理。
每个账户最多允许 5 个 Webhook 端点。如果您更喜欢轮询，请让间隔适中；整个账户的限额是每分钟 300 次请求。HMAC Webhook 指南有更完整的检查清单。
巴拉圭线路上开放了哪些服务？
巴拉圭目前提供 1,600 多种服务。最常被请求的包括 WhatsApp、Instagram、Telegram、Uber、Facebook、TikTok、Google (Gmail & YouTube)、Microsoft & Outlook、X (Twitter)、Discord、LinkedIn、Netflix 和 ChatGPT (OpenAI)。WhatsApp 是该地区许多人日常使用的通讯工具，所以在测试基于聊天的客服时，它往往是团队首先验证的服务。
+595 手机号码如何书写和规范化？
巴拉圭国内拨号使用长途前缀 0，因此在本地看到的手机号码以 09 开头。在 E.164 中这个 0 要去掉：规范形式是 +595 加九位数字，手机号以 9 开头。请在输入时做规范化，只存储 E.164 形式，并在界面边缘再格式化显示。期望其他国家固定长度的校验规则，是巴拉圭用户注册失败的常见原因，所以请在校验测试用例中加入 +595 号码。
西班牙语和瓜拉尼语都是官方语言。国际服务发来的验证消息，视模板和账户设置，往往是西班牙语或英语。请用只匹配数字的正则解析验证码，并以 UTF-8 保存消息正文，这样带重音的字符和 ñ 在日志中不会丢失。
团队为什么要在巴拉圭验证账户？
巴拉圭是南方共同市场（Mercosur）的成员，位于阿根廷、巴西和玻利维亚之间，所以已经在该地区运营的公司常把它加入南美的推广计划。在那里测试的典型原因包括：面向巴拉圭受众的西班牙语本地化 QA、确认区域注册流程接受 +595 号码、运营团队为本地客户验证企业资料，以及为用家乡号码注册的海外巴拉圭人提供支持。移动应用验证页面介绍了这些检查如何融入发布测试。
有无需写代码的方式获取巴拉圭验证号码吗？
有。在控制台中打开 OTP Gateway，选择巴拉圭和服务，查看价格并确认。把号码复制到应用中，然后让激活保持打开，直到验证码出现在它旁边。浏览器订单和 API 订单使用同一个钱包和历史记录。
+595 验证码没出现时该怎么办？
在下结论之前，让激活走完完整的 20 分钟窗口。如果它空着结束，费用会自动退回。然后排查常见原因：服务可能拒绝虚拟号码，该时段线路可能拥堵，或者换一条服务线路稍后可能成功。不要高频连续地反复下单；在尝试之间加入退避，并记录 activation id，以便按服务找出规律。
我能长期保留巴拉圭号码吗？计费如何处理？
巴拉圭不提供可自助开通的长期线路。专用虚拟号码（Dedicated Virtual Numbers）只存在于美国和加拿大，$1.95/月起，所以必须持续登录的账户常常转挂在其中一个号码上。如想咨询巴拉圭的长期线路，请发邮件至 [email protected]；答案取决于当地规定。
计费使用一个预付美元钱包：用银行卡或 USDT/USDC 充值，通过邮件收到 PDF 发票，只为送达的验证码付费。开发账户可按需切换到沙盒，获得模拟的号码和验证码。OTP Route 用于测试和运营您自己的合法产品；请遵守各服务的条款以及可接受使用政策。
常见问题
OTP Route API 中巴拉圭的国家 id 是什么？
是 py。在价格查询以及 POST /api/v1/activations 的请求体中使用它。
巴拉圭号码要带 09 前缀存储吗？
不要。去掉国内的 0，存储 +595 加九位国内号码。
测试用的 +595 号码多少钱？
巴拉圭的激活视服务而定，每条验证码 $0.20 起，只有真正送达的验证码才会从钱包扣费。
没有本地 SIM 卡，能测试巴拉圭的西班牙语注册流程吗？
可以。在 OTP Gateway 订购巴拉圭验证号码，然后在控制台或通过 API 读取验证码。
验证码会以瓜拉尼语送达吗？
即便有也很少。国际服务通常发送西班牙语或英语文本，所以只解析数字即可。
激活过期的话，我的钱会怎样？
20 分钟窗口内没有短信到达时，全额金额会自动退回您的钱包。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。