年龄验证如何运作
第一步,验证手机号。您用 flow=age 调用 POST /start-verification,并将返回的 WhatsApp 深度链接在桌面端渲染为二维码,在移动端渲染为按钮。访客从自己的 WhatsApp 账号发送一条预填消息,因此是通过发送这一行为而非您向其号码投递的验证码来证明对号码的控制权。
第二步,设置门槛。同一个调用可接受可选的 min_age。省略时,将采用您账户中配置的门槛,除非您更改过,否则为 18。min_age 仅在 flow=age 时被接受,且必须为正整数,其他情况都会返回 400。
第三步,完成年龄核查。手机号部分一经证明,响应中就会带有状态为 pending 的 age 数据块和一个 age_verification_url。访客会通过 WhatsApp 收到同一个一次性链接,您也可以用它引导访客在其当前所用的浏览器中继续。他们在年龄服务商处作答,然后返回您的 callback_url,并附带 token 以及 age=verified、denied 或 failed。
第四步,接收结果。服务商给出答复后,会触发第二个 webhook age_verification_result,GET /check-verification-status 也会报告同样的内容。age 数据块包含 status、verified、required(实际核查所用的门槛)、verified_at 和 provider。
在编写轮询循环之前,有一个陷阱值得了解:手机号一经证明,会话自身的状态就会变为 verified,而此时 age.status 仍为 pending。请把 age 数据块作为年龄步骤的信号,切勿使用会话状态。
手机号验证 + 年龄验证
这两个步骤回答两个不同的问题,流程有意把它们分开。发送 WhatsApp 消息证明访客控制着该号码,但对其年龄只字未提:手机号不是年龄证明,本流程的任何部分都不会将其视为年龄证明。
手机号步骤带给您的是存放答案的位置。单独的年龄结果是一个没有归属的事实,即某地的某人通过了某个门槛。绑定到访客刚刚明确使用过的号码后,它就成了您下次访问时能够识别的东西。
这也让回访用户的成本很低。通过的结果会针对该手机号保留一年,因此已经通过同一门槛的人只需重新证明号码,并沿用之前的答案,而不必再被送回服务商。当您需要全新的答案时,在 WhatsApp 消息末尾加上 #reset 即可跳过缓存。
无需建立身份数据库即可验证年龄
年龄门槛提出的问题是一个布尔值,而为回答它通常收集的大部分数据却不是,这正是证件存档如此不划算的原因:您为了存下一个“是”,最终却持有护照和驾照。
您的应用所需要的很少:结果(verified、denied、failed 或仍为 pending)、所核查的门槛、答复的时间以及答复的服务商,还有把答案与眼前访客联系起来的会话标识符和已验证的手机号。这就是整个 age 数据块,加上手机号流程本就会返回的内容。
您的应用不需要出生日期或身份证件,API 也不会返回这两者,因此不会有误记录的字段。通过的答案会以答案、门槛和日期的形式针对手机号保留。服务商的凭据保存在服务端密钥中,服务商为作出决定而查看的任何内容都不会传递给您。
以上都不代表对您自身义务的说明。您需要核查什么、必须能在多长时间内证明自己核查过,以及什么算可接受的方法,这些问题应当咨询您的法律顾问和监管机构,而不是 API 供应商。
年龄验证与身份验证的区别
年龄验证回答一个问题:这位访客是否达到您设定的年龄门槛?身份验证回答另一个问题:这个人是谁?两者常被捆绑销售,但涉及的数据量截然不同。
flow=age 属于前者。它不返回姓名、出生日期,也不返回证件中的任何内容。它不是 KYC,通过的结果也不是可以在别处依赖的身份声明。如果您的义务是了解客户是谁,这个工具无法覆盖这部分需求。
它还继承了所有基于手机的核查所依据的假设:号码属于使用它的人。通过发送消息来证明控制权,比接收短信更为牢靠,但青少年使用成年人手机的情形,是任何远程核查都无法完全杜绝的。下文链接的那篇关于不会变成身份证件数据库的年龄核查文章,对架构、四种状态和局限性作了更详细的说明。
将年龄验证集成到您的应用
它使用的是每个 Phone-Verif 集成都会用到的两个 REST 调用,只是更改了一个参数。在 x-api-key 请求头中使用您的 API 密钥进行认证,用 flow=age 开启会话,然后从状态端点或 webhook 读取 age 数据块。
- 访客
- 通过 WhatsApp 进行手机号验证
- 服务商处的年龄核查
- 年龄结果
- 您的应用
这两个步骤回答两个不同的问题,并且全程保持独立。发送 WhatsApp 消息只证明访客控制着该号码,绝不会被当作其年龄的证据。年龄结果由年龄步骤产生。
curl -X POST "https://api.phone-verif.com/start-verification?flow=age&min_age=18" \
-H "x-api-key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"session_id": "checkout-4821", "callback_url": "https://your-app.example/age-checked"}'用 flow=age 开启会话。省略 min_age 时,将采用您账户中配置的门槛,除非您更改过,否则为 18。
{
"status": "verified",
"age": { "status": "pending", "verified": false, "required": 18 },
"age_verification_url": "https://t.phone-verif.com/av/AbCd1234"
}手机号一经证明,会话即进入 verified 状态,此时年龄步骤仍未完成。请读取 age.status 而非会话状态来获取年龄答案,并将访客引导至 age_verification_url,让其在当前所用的浏览器中完成核查。
{
"event": "age_verification_result",
"session_id": "checkout-4821",
"validation_token": "...",
"age": {
"status": "verified",
"verified": true,
"required": 18,
"verified_at": "2026-09-01T22:00:00.000Z",
"provider": "ageverif"
}
}服务商给出答复后,第二个 webhook 会携带结果,状态端点也会报告同样的数据块。
flow=age 需要在您的账户上配置年龄服务商。若未配置就发起请求,API 会返回 503 及错误码 age_not_configured,这样配置错误就能与服务中断区分开来。
年龄验证常见问题
- 我可以验证用户是否年满 18 岁吗?
- 可以。用 flow=age 开启会话并省略 min_age,流程就会按您账户中配置的门槛进行核查,除非您在设置中更改过,否则为 18。
- 我可以使用不同的最低年龄吗?
- 可以。在开始调用中传入 min_age 并指定您需要的门槛。它必须是正整数,仅在 flow=age 时被接受,其他情况会以 400 拒绝。每个会话都会保留其开启时所对应的门槛,该门槛会在 age 数据块中以 required 返回,因此之后的读取者能知道实际确立了什么。
- 我需要存储用户的出生日期吗?
- 不需要,而且即使想存也存不了:API 不会返回出生日期。返回的内容是门槛是否达标、门槛是多少、何时作出答复以及由哪个服务商答复。
- 我需要存储身份证件吗?
- 不需要。服务商为得出答案可能需要查看证件,而您的应用只会收到答案。API 不会返回证件中的任何内容,因此您无需存储任何东西。
- 年龄验证能证明一个人的身份吗?
- 不能。flow=age 回答的是持有已证明手机号的人是否达到某个门槛。它不是身份验证,也不是 KYC:没有姓名,没有出生日期,也没有证件。
- 年龄验证失败会怎样?
- denied 和 failed 是不同的结果,不应混为一谈。denied 是服务商作出的决定,重新运行也不会改变答案。failed 表示无法联系到服务商,因此没有作出任何决定,重试是合理的。拒绝或服务商故障不计费;已完成的年龄核查会在手机号验证之外按第二个单位计费。
- 我可以把手机号验证和年龄验证结合起来吗?
- flow=age 正是如此。一个会话先通过 WhatsApp 证明手机号,再运行年龄步骤,两个结果都会在同一个会话上返回。您无需运行两套集成,也不必对齐两个标识符。
- 我可以强制对回访用户重新核查吗?
- 可以。通过的结果会针对同一手机号和同一门槛复用一年。在 WhatsApp 验证消息末尾加上 #reset 会跳过缓存的答案,并让访客重新经历完整的核查。
Related
年龄验证使用场景
成人内容
自行勾选声明已不再被视为有效核查的场景。年龄结果在提供任何内容之前控制访问,且不要求访客向您上传证件。
在线博彩
必须拒绝未成年玩家的博彩和赌场账户。核查可在注册时进行,若您自己的规则要求,也可在敏感操作前再次进行。
酒类及限龄商品
酒水、烟草、电子烟、刀具、溶剂和烟花。核查位于结账之前,针对订单而非浏览会话。
游戏
有年龄分级的游戏、聊天功能以及对特定年龄以下限制的付费机制。门槛是请求参数,因此不同功能可以要求不同的门槛。
交易市场
受法律或您自身政策限制的商品列表。通过以不同的 min_age 开启会话,可对买家和卖家设置不同的门槛。
社交与社区平台
针对账号、私信或直播功能的最低年龄规定。答案与经过证明的手机号绑定,因此在会话结束后依然有效。
Build your 年龄验证 flow today
Start integrating in minutes with clear documentation, SDKs, and global message delivery.