事前检查：测试波兰注册前我需要准备什么？
把这份清单过一遍，第一次波兰订单通常会很平稳：
- 凭证。 在开发者控制台生成一个 Bearer 密钥（以
or_live_开头）。为预发布、CI 和生产分别使用不同的密钥，轮换起来毫无负担。 - 标识符。 波兰是
pl。请从GET /api/v1/services获取服务 id，而不是硬编码显示名称。 - 资金。 给钱包充值；每个价格在下单前都可见。
- 投递目标。 注册一个 HTTPS Webhook，并把它的密钥放在源代码管理之外。如果入站流量被阻止，轮询同样可行。
- 请求预算。 API 允许每个账户每分钟 300 次请求，所以请相应地限制并行测试套件。
- 范围。 只验证属于您自己产品、您的公司或您客户的账户，并在遵守各服务条款的同时遵守我们的可接受使用政策。
专门针对流水线的内容，请参阅 CI 流水线中的短信 OTP 测试。
目前有哪些服务会向 +48 号码发送验证码？
就 OTP 路由而言，波兰是目录中覆盖较广的条目之一，涵盖 2,300 多种服务。当前快照中的热门服务包括 Facebook、Instagram、TikTok、WhatsApp、Telegram、Viber、Signal、Snapchat、Discord、X (Twitter)、LinkedIn、Google (Gmail & YouTube)、Amazon、AliExpress、Uber 和 Netflix。
请把这份列表当作起点，而不是承诺。任何线路的可用性都会在一天中变化，所以每次下单前，请就具体组合向价格接口查询。
波兰 OTP API 的具体步骤是什么？
使用位于 https://otproute.com/api/v1 的短信验证 API，自动化测试会这样做：
GET /api/v1/prices?country=pl&service=<id>确认该服务在波兰的实时价格。POST /api/v1/activations，请求体{"service": "<id>", "country": "pl"}，返回 +48 号码和 activation id。- 您的测试把号码输入注册表单并请求短信。
- 处理程序收到
activation.sms_received；如果看到activation.expired或activation.cancelled，就把这次运行标记为未送达。 - 没有 Webhook 时，每隔几秒读取一次
GET /api/v1/activations/{id}，直到验证码出现或窗口结束。 - 测试提前拆除时调用
POST /api/v1/activations/{id}/cancel。
在信任任何负载之前先校验 X-OTPRoute-Signature 头部：它包含 t=<unix>,v1=<hex>，其中 v1 是用端点密钥对 <t>.<raw body> 签名的 HMAC-SHA256。拒绝时间戳过旧的请求，并让处理程序以 activation id 保持幂等。Webhook 安全指南详细展示了这项检查。
运营团队不用 API 也能订购波兰号码吗？
可以。在 OTP Route 控制台中打开 OTP Gateway，选择波兰，搜索服务并确认显示的价格。下单后，把波兰验证号码复制到应用的验证页面，并观察激活卡片；收到短信后，文本会出现在那里。无需安装任何东西，同一个钱包既为浏览器也为 API 付费。
处理波兰号码和消息有什么不同？
波兰使用封闭的编号方案，没有长途前缀：每个号码，无论手机还是固话，在 +48 之后都是九位数字。这使校验变得相当严格。请拒绝无法化简为九位国内数字的输入，去掉用户按三位一组添加的空格和短横线，并将 +48 加九位数字作为一个 E.164 字符串存储。多余的开头零是笔误，不是需要保留的前缀。
当账户语言为波兰语时，验证消息通常以波兰语送达。ą、ę、ł 和 ż 等字符不在 GSM 7 位字母表之内，所以如果您自己发送波兰语 OTP 短信，预计会出现更短的分段，请按它在手机上的实际显示来测试模板。解析收到的验证码时，只认数字，忽略周围的词语。
在此测试的常见原因：产品进入波兰市场、波兰语流程的本地化 QA、负责中欧各地业务账户的区域团队，以及客户中包括生活在欧盟其他地区的波兰语使用者的应用。
排错：为什么 +48 验证码缺失？
- 窗口仍然开放。 在得出结论之前给它完整的 20 分钟；只有验证码到达才会计费。
- 服务可能拒绝虚拟号码。 有些平台会，这时自动退款会把全额金额放回钱包。
- 线路繁忙。 稍后重试，或测试另一条服务线路。
- 测试在循环。 每隔几秒就重新下单会耗尽您的请求预算；请加入退避。
更多做法收集在减少 OTP 投递失败中。
波兰有专用号码吗？付款如何进行？
不能作为自助产品。专用虚拟号码（Dedicated Virtual Numbers）$1.95/月起，仅在美国和加拿大提供。如需长期的波兰线路，请发邮件至 [email protected] 咨询；是否可行由当地规定决定，所以不作承诺。
付款进入一个预付美元钱包：无套餐、无月费，可用银行卡或 USDT/USDC 充值，每次充值都会通过邮件发送 PDF 发票。开发者可以为开发账户申请沙盒模式，在构建集成时接收模拟的号码和验证码。实时价格见价格。
常见问题
如果团队里没有人有 +48 SIM 卡，如何测试波兰注册流程？
在 OTP Gateway 订购一个 +48 测试号码并在流程中使用。验证码会显示在控制台，并且可以发送到您的 Webhook。
OTP Route API 调用中波兰的国家代码是什么？
是 pl，在 POST /api/v1/activations 和价格查询中都会用到。
波兰电话号码有几位数字？
+48 之后是九位国内数字，没有长途前缀的零。固定的长度使服务端校验变得简单直接。
接收波兰短信 OTP 要多少钱？
价格从每条验证码 $0.20 起，因服务而异。下单前，控制台和价格接口会显示确切的数字。
如果波兰激活空着过期，我会损失钱吗？
不会。没有验证码就结束的激活，或您取消的激活，都会全额退回钱包。
上线前我能模拟整个波兰流程吗？
可以。为开发账户申请沙盒模式，即可在不动用钱包资金的情况下获得模拟的号码和验证码。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。