获取 +507 验证码要调用哪些接口？
所有接口都位于 https://otproute.com/api/v1 之下，使用以 or_live_ 开头的 Bearer 密钥认证。巴拿马的国家 id 是 pa。一个测试用例的典型流程如下：
GET /api/v1/prices?country=pa&service=whatsapp返回该组合的实时价格，如果超出您设定的预算，运行器可以就此停止。POST /api/v1/activations，请求体{"service": "whatsapp", "country": "pa"}，预留一个号码并返回 activation id。- 您的测试在注册页面输入该号码并触发短信。
- 验证码通过 Webhook 事件，或通过
GET /api/v1/activations/{id}送到您手中。 POST /api/v1/activations/{id}/cancel提前结束一次运行并退款。
大型测试套件开始前请先调用 GET /api/v1/balance，避免钱包耗尽表现为一大批虚假失败。开发者概览和完整的 API 参考列出了请求与响应的细节。
巴拿马线路应该依赖 Webhook 还是轮询？
对于巴拿马 OTP API 集成，Webhook 是更干净的选择。请注册一个端点（每个账户最多 5 个），并订阅 activation.sms_received、activation.expired 和 activation.cancelled。每个请求都带有 X-OTPRoute-Signature: t=<unix>,v1=<hex>；请用端点密钥重新计算 "<t>.<raw body>" 的 HMAC-SHA256，以恒定时间比较，并丢弃时间戳过旧的请求。让处理程序以 activation id 为键，这样重试的投递永远不会把同一个验证码处理两次。
轮询适合简短的脚本，或无法接受入站调用的网络。请把请求间隔拉开；账户限额是每分钟 300 次请求，由最多 10 个密钥共享，对同一个激活进行高频循环会浪费这份额度。更多做法见我们的文章基于 Webhook 的 OTP 捕获。
关于巴拿马电话号码，我的代码需要了解什么？
巴拿马没有长途前缀，所以国内号码直接跟在 +507 之后。手机号码是八位，以 6 开头，而固话是七位，如果您的校验器对全国强制单一长度，这一点就很重要。
- 以 E.164 持久化号码，例如手机号为
+5076再加七位数字。 - 输入时接受第四位数字后的短横线，因为这是本地常见的手机号写法，保存前再去掉。
- 在仅限短信的流程中拒绝七位数字的输入，因为它几乎肯定是无法接收验证码的固话。
西班牙语是官方语言，所以当应用按地区或账户语言本地化时，验证短信通常以西班牙语送达。请检查您自己的消息模板、字符计数以及任何验证码提取正则能否处理带重音符号的字符。
团队为什么要在巴拿马测试或运营？
运河、航运物流贸易以及庞大的国际服务业，使巴拿马成为覆盖中美洲和加勒比地区的区域总部的常见驻地。在该地区推出西班牙语应用的产品团队，常从这里开始本地化 QA，而设在别处的运营团队仍需要证明持 +507 号码的客户能完成注册流程。
OTP Gateway 的巴拿马验证号码让他们在任何办公室都能做到这一点。当测试并不特别需要巴拿马时，邻近线路如哥斯达黎加或哥伦比亚，可以用来对比国家路由的行为。
巴拿马线路上哪些服务可以接收验证码？
今天的快照列出了 WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、ChatGPT (OpenAI)、Claude、Microsoft & Outlook、Amazon、Uber、eBay、Airbnb 和 Netflix。该线路目前一共提供 1,000 多种服务。库存会在一天中变化，所以请始终读取 GET /api/v1/services 或控制台，而不是硬编码列表。
非开发人员可以在浏览器中获得同样的覆盖：注册、充值、选择服务和巴拿马、确认显示的价格、把号码复制到应用里，然后等待验证码出现在订单旁边。
巴拿马号码收不到任何内容时怎么处理？
20 分钟的窗口是您的安全网：只有验证码送达才会计费，过期或取消的激活会自动全额退款。当号码一直没动静时：
- 让它运行到过期，不要在几秒内取消再重新下单；高频循环在发送服务看来很可疑。
- 暂停一会儿再重试，或者换一条服务线路。
- 确认该服务接受虚拟号码；有些服务直接拒绝，退款就是为这种情况准备的。
- 记录
activation.expired事件，让不稳定的运行可见，而不是悄无声息。
这些号码用于测试和运营您自己的合法账户。请遵守每个发送服务的条款，并记住 OTP Route 的可接受使用政策适用于每一笔订单。
长期的巴拿马线路、计费和沙盒测试怎么办？
OTP Route 不销售可自助开通的巴拿马长期号码。专用号码（Dedicated Numbers）仅限美国和加拿大，$1.95/月起；如需巴拿马线路，请发邮件至 [email protected]，团队会告诉您当地规定是否允许。
付款通过一个预付美元钱包完成，无月费、无套餐，可用银行卡或 USDT/USDC 充值，每次充值都会通过邮件发送 PDF 发票。开发账户可按需切换到沙盒，返回模拟的号码和验证码，让您无需动用钱包资金即可测试完整流程。实时价格请见价格。
常见问题
我能在 CI 流水线中自动化巴拿马短信验证吗？
可以。通过 REST API 以国家 pa 创建激活，然后从签名 Webhook 或通过轮询激活来获取验证码。
巴拿马手机号码有多长？
手机号码是八位，以 6 开头，写在 +507 之后，没有需要去掉的长途前缀。
接收巴拿马短信 OTP 要多少钱？
每条验证码 $0.20 起；下单前，API 的价格接口会返回每项服务的确切金额。
验证码没到，会从钱包扣费吗？
不会。在 20 分钟窗口内没有短信，或取消之后，金额会自动退回。
巴拿马的验证消息会是西班牙语吗？
通常是，只要应用按地区或账户语言做了本地化，所以请确保任何解析逻辑都能处理西班牙语文本。
没有本地 SIM 卡，能测试我的巴拿马注册流程吗？
可以。OTP Gateway 的 +507 号码一次可接收一条验证码，所以您的团队永远不需要巴拿马的手机。
我能购买永久的 +507 号码吗？
不能自助开通。长期专用号码是美国和加拿大的产品；如想咨询巴拿马，请发邮件至 [email protected]。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。