实名认证
三个 HTTPS 请求接通支付宝实人认证。用户在支付宝里刷脸, 你拿回一个是或否——中间的照片、视频、证件原件,都不经过你的服务器。
核验记录
核验通过
- 姓名
- 张*
- 认证时间
- 2026-11-14 21:56
- 公民身份号码
110105********002X- 凭证号
75ea0726…1d57bef8
三个请求,中间隔着一分钟
-
换凭证
POST /api/v1/credentialAppid 加签名换一个一次性 token。
返回
token,用掉即废 -
建单
POST /api/v1/certify/create按单价冻结余额,拿回跳转地址。
返回
pay_url与单据号 -
用户刷脸
支付宝客户端用户在自己的手机上完成,照片与视频只到支付宝。
耗时 1~3 分钟
-
查结果
POST /api/v1/certify/query凭单据号查一次,得到通过与失败原因。
返回
passed与失败原因
换凭证与查结果各几十毫秒;建单之后,用户在支付宝里刷脸, 那一段时间不经过你的服务器。三个请求做完,最后只回一个布尔值。
{ "passed": true }
留下的,与不留的
实名认证会经手一个人的全部身份信息。所以先讲清楚:哪些留在库里, 哪些从头到尾只是一次性的。
张* 110105********002X 通过
- 姓名
- 只留第一个字,其余打码
- 号码
- 保留首尾,另存一条不可逆摘要用于查重
- 结论
- 通过与否、时间、单据号,够你回查与对账
不会留下的
- 身份证正反面照片
- 明文证件号
- 人脸照片与活体视频
- 统一账号的登录凭证
这些只在认证过程中由支付宝处理,本站不接收、不转发、不写日志。
冻结,再决定
建单那一刻先冻结一次费用,人还在刷脸时这笔钱既不算花掉也不算可用。 通过才结算,未通过或超时,原路退回。
| 时间 | 动作 | 可用 | 冻结 |
|---|---|---|---|
| 21:50 | 建单,冻结 | ¥1,286.00 | ¥3.00 |
| 21:51 | 未通过,退回 | ¥1,287.00 | ¥2.00 |
| 21:54 | 重新建单,冻结 | ¥1,286.00 | ¥3.00 |
| 21:56 | 通过,结算 | ¥1,286.00 | ¥2.00 |
算一下
单价 ¥1.00,未通过的次数不计费。 每个应用可以在控制台单独设单价。
接好之后,都在一个后台里
应用与密钥、余额与流水、每一笔订单的结果,同一个页面里对得上账。
- Appid
YWV10001- Secret
e3b0••••••••1f24- 可用余额
¥1,286.00- 冻结金额
¥2.00- 认证单价
¥1.00 / 次- 状态
- 正常
| 时间 | 姓名 / 证件号 | 状态 |
|---|---|---|
| 21:56 | 张* · 110105********002X | 已通过 |
| 21:51 | 李* · 310101********1234 | 未通过 |
| 21:50 | 王* · 440301********5678 | 待认证 |
| 19:04 | 赵* · 510104********4321 | 已过期 |