Proton Mail 短信验证：测试清单与工作流程

申请 Proton Mail 验证码前的准备清单

先做好准备工作，Proton Mail 短信验证测试才会顺利：

• 弄清 Proton 为什么要验证。确认该页面在本次注册或找回步骤中确实提供短信验证选项。
• 有目的地选择国家。与账号所在市场或测试计划中的场景一致。
• 检查价格与可用性。调用 GET /api/v1/prices?country=<id>&service=protonmail，或在控制台中查看。
• 准备好接收端。一个订阅了 activation.sms_received 的 webhook 端点，或者间隔合理的轮询循环。
• 规划邮箱的未来。如果以后需要找回或重新验证，专用号码可能更合适。
• 再读一遍规则。Proton 的条款与 OTP Route 的《可接受使用政策》都适用。

Proton Mail 在哪些环节会要求手机号码？

Proton Mail 是注重隐私的邮箱服务，对手机号码的使用降到最低。常见的时机是注册时的真人验证：当 Proton 想进一步确认新账号属于真实用户时，可能提供短信验证码作为多种方式之一。账号持有人也可以添加号码作为找回方式。Proton 的两步登录依赖验证器应用或安全密钥，而不是短信，因此注册时使用一次的号码，在以后登录时并不需要，除非你同时把它保存为找回手机。

分步指南：Proton Mail 验证码 API

1. 使用在开发者控制台创建的 Bearer 密钥（前缀 or_live_）进行认证。
2. 用 GET /api/v1/prices?country=de&service=protonmail 查询价格，也可换成其他国家 id。
3. 通过 POST /api/v1/activations 下单，请求体为 {"service": "protonmail", "country": "de"}。
4. 在 Proton 的验证字段中输入返回的号码。
5. 接收验证码。你的 webhook 会收到 activation.sms_received；请校验 X-OTPRoute-Signature 头（以端点密钥为密钥，对时间戳、一个点和原始请求体做 HMAC-SHA256），并拒绝过期的时间戳。也可以改为轮询 GET /api/v1/activations/{id}。
6. 以激活 id 为键记录结果，使重复投递的 webhook 只会被处理一次。

每个账号允许 10 个 API 密钥、5 个 webhook 端点，以及每分钟 300 次请求。更详细的演练请参阅 基于 webhook 的 OTP 捕获。

分步指南：在控制台完成同一任务

1. 登录并打开 OTP Gateway。
2. 搜索 Proton Mail 并选择国家。
3. 查看显示的价格，然后确认。
4. 把号码粘贴到 Proton 的短信验证页面。
5. 保持订单开启；消息到达时，验证码会显示在号码旁边。
6. 如果 Proton 始终不发送，可以取消，或等待 20 分钟窗口到期。无论哪种方式，钱包都会收到退款。

哪些国家可以提供 Proton Mail 手机号码？

Proton Mail 线路目前覆盖 197 个国家。示例包括瑞士、德国、英国、巴西、印度、法国、西班牙、墨西哥、印度尼西亚、菲律宾、尼日利亚、肯尼亚、日本、波兰和美国。国家的选择很重要：测试德语注册路径应使用德国号码，而由巴西团队运营的账号使用巴西号码会显得更一致。任何服务的实时选项，都可通过 GET /api/v1/countries 并结合价格接口获得。

故障排查：Proton Mail 短信没有到达

• 虚拟号码被拒绝。Proton 可能拒绝它视为虚拟的号码。请选择其他真人验证方式或另一条线路；退款会覆盖这次尝试。
• 暂时没有。让 20 分钟窗口走完，而不是立刻重新下单；快速重复下单通常没有帮助。
• 线路繁忙。稍后重试，或选择另一个仍符合测试场景的国家。
• webhook 无反应。检查端点密钥、签名逻辑和服务器时钟，然后与直接调用 GET /api/v1/activations/{id} 的结果比对。

什么时候专用号码是更好的选择？

一次性号码适合注册检查，但不适合团队几个月后还要找回的邮箱，因为那个号码以后将无法再被联系到。如果账号需要一个可用的找回手机，例如共享支持邮箱或回归测试用的测试环境账号，请使用美国或加拿大的专用虚拟号码，$1.95/月起。续费期间你可以一直持有它，在控制台中并通过 number.sms_received 在 webhook 上接收短信，也可以随时释放。一次性号码与专用号码对两者做了深入比较。

负责任的使用与计费

Proton 把产品建立在隐私之上，这值得尊重。请使用 OTP Route 号码来测试你自己的注册流程、开通业务确实需要的账号，或让员工的个人号码不出现在共享登录上：每位真实用户或每家企业一个账号，并遵守 Proton 的条款。计费采用无月费的预付美元钱包，可用银行卡或 USDT/USDC 充值，每次充值附 PDF 发票，集成开发时可申请沙盒。隐私优先注册页面介绍了相关的工作流程。

常见问题

如何通过 API 接收 Proton Mail OTP 验证码？

用服务 protonmail 和你选定的国家创建激活，在 Proton 中输入号码，然后从 activation.sms_received webhook 或通过轮询该激活来获取验证码。

Proton 会接受用于 Proton Mail 注册的虚拟号码吗？

并非每次都会。Proton 自行决定信任哪些号码；如果 20 分钟内没有验证码到达，系统会自动退款。

以后可以用同一个号码找回账号吗？

一次性的 OTP Gateway 号码不行。如果需要一个长期保留的找回手机，请使用专用号码，目前仅在美国和加拿大提供。

Proton 会用短信做双重验证登录吗？

不会。Proton 的两步登录使用验证器应用或安全密钥。短信主要出现在真人验证和作为找回选项时。

可以在不花钱的情况下演练 Proton Mail 验证吗？

集成开发时可以：请联系支持把开发账号切换到沙盒，它会返回模拟号码和验证码。真正的 Proton 验证码仍需要实际下单。

可以用这种方式开设多个 Proton 账号吗？

不可以。请保持每位真实用户或每家企业一个账号并遵守 Proton 的条款；OTP Route 用于测试和运营你自己的合法账号与产品。

服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。