场景：一个取决于单个手机号码的出行账号
DiDi 是网约车和出行平台，与该类别的大多数应用一样，它把手机号码视为账号的核心。短信验证码通常在注册、在新设备登录和账号找回时被请求；司机和配送员入驻也依赖同样的检查。
这给合法的业务工作带来了麻烦。运营企业乘客账号的公司，不希望它绑定在某个员工的个人手机上。为客户管理差旅的代理机构，需要一个原签署人之外的其他人也能完成的验证步骤。开发与 DiDi 账号关联的产品的 QA 团队，希望演练流程，而不必在办公室里传递私人手机。每次验证只使用一次的 DiDi 虚拟号码，可以让这些步骤远离任何人的私人 SIM 卡。
哪些国家可以提供 DiDi 手机号码？
didi 线路目前覆盖 198 个国家。团队通常从打车需求旺盛的市场开始，例如墨西哥、巴西、智利、哥伦比亚、秘鲁、阿根廷、哥斯达黎加、巴拿马、多米尼加共和国、厄瓜多尔、澳大利亚、新西兰、日本和香港。
请有意识地选择国家。将在圣地亚哥使用的乘客账号，应该用智利号码验证；针对墨西哥注册页面的回归测试，则需要墨西哥号码。号码所属国家与账号所属市场不一致，是测试在纸面上通过、却在真实应用中失败的常见原因。完整列表见国家。
DiDi 验证码 API 流程如何运行？
DiDi 流程与其他所有线路使用相同的基础 URL https://otproute.com/api/v1，并在 Authorization 头中放入 or_live_ 密钥。
- 查询
GET /api/v1/prices?country=<id>&service=didi，查看该线路是否开放以及当前价格。 - 通过
POST /api/v1/activations下单，请求体类似{"service": "didi", "country": "mx"}。 - 在你正在测试的 DiDi 页面输入返回的号码并请求短信。
- 从 webhook 读取验证码，或轮询
GET /api/v1/activations/{id}直到它出现。 - 如果打车预订测试中途放弃，请通过
POST /api/v1/activations/{id}/cancel释放号码。
每个账号最多可持有 10 个密钥和 5 个 webhook 端点，限制为每分钟 300 次请求。
应该如何编写 DiDi 的 webhook 处理程序？
订阅 activation.sms_received，同时也订阅 activation.expired 和 activation.cancelled，让你的测试知道何时可以停止等待。每次投递都带有 X-OTPRoute-Signature: t=<unix>,v1=<hex>；请用端点密钥对 "<t>.<raw body>" 重新计算 HMAC-SHA256，以恒定时间比较，并丢弃时间戳过旧的任何内容。
事件以激活 id 为键，所以下单时保存该 id，并把针对同一 id 的第二次投递视为空操作。这种幂等性很重要，因为被重试的 webhook 绝不应该把 DiDi 验证码提交两次。如果入站 webhook 在你的环境中不方便，轮询激活接口同样可行。基于 webhook 的 OTP 捕获一文比较了这两种方式。
在控制台接收 DiDi OTP
运营人员可以完全跳过 API。登录，为钱包充值，打开 OTP Gateway，搜索 DiDi，选择与账号匹配的国家，并在确认前查看显示的价格。号码会出现在激活卡片上，DiDi 发出验证码后，它就会显示在那里。激活保持 20 分钟有效。
为什么 DiDi 验证码可能没有到达？
有几个普通的原因可以解释激活为何是空的：
- DiDi 和许多平台一样，可能在某些线路上或某些时段拒绝虚拟号码。
- 所选国家的线路可能繁忙；可用情况在一天中不断变化。
- 测试期间，应用可能对来自同一设备或会话的重复请求进行限流。
补救办法是耐心，而不是激进。让窗口走完，稍后重试，或使用另一个仍符合测试的国家，并避免在紧密循环中重新下单。未送达不会让你花钱：窗口关闭或你取消时，全部金额会自动退回钱包。
DiDi 账号什么时候应该使用专用号码，适用哪些规则？
一次性激活适合单次验证。如果同一个 DiDi 账号下个月还要再登录，例如测试环境乘客账号或共享的企业登录，专用号码能让这条线路始终在你的掌控之下。它们仅在美国和加拿大提供，$1.95/月起，入站短信显示在控制台并发送到你的 webhook。详情见虚拟号码。
请仅将 OTP Route 用于测试和运营你自己的合法产品与账号。遵守 DiDi 的条款，保持每位真实用户或每家企业一个账号，并请注意 OTP Route 的《可接受使用政策》适用。OTP Route 与 DiDi 没有关联，该名称是其所有者的商标。
常见问题
用于 DiDi 短信验证测试的服务 id 是什么？
在 service 字段中使用 didi，并搭配你所测试市场的国家 id。
没有墨西哥 SIM 卡，也能为墨西哥账号接收 DiDi OTP 吗？
可以，前提是墨西哥线路开放：用国家 mx 和服务 didi 订一个号码，然后通过 API 或在控制台读取验证码。
如果 DiDi 始终不发送验证码，我需要付费吗？
不需要。20 分钟内没有收到短信的激活，或你取消的激活，都会全额退回钱包。
DiDi 会接受所有虚拟号码吗？
不一定。某些线路可能被拒绝，所以请稍后重试，或使用另一个合适的国家。
可以不花钱包资金来测试 DiDi 集成吗？
可以。开发账号可按要求切换到沙盒，返回模拟号码和验证码，用于端到端测试。
DiDi 激活如何付款？
用银行卡或 USDT/USDC 为预付美元钱包充值；没有月费，每次充值都附 PDF 发票。当前价格见价格页面。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。