身份证实名认证
低至￥0.01/次
立即申请功能介绍 / Introduction
核验身份证二要素（姓名和身份证号码）信息是否一致。广泛应用于出行住宿、购票等需要身份核验的场景。
产品功能
- 高精准核验
- 毫秒级响应
- 加密传输保护隐私
- 支持MCP调用
API文档 / Documentation
接口地址
POST / /v1/id_verify Content-Type: application/x-www-form-urlencoded
签名算法
1. 将所有请求参数（除 sign 外）按参数名 ASCII 升序排列
2. 拼接成 key1=value1&key2=value2&... 格式
3. 在拼接串末尾追加 API密钥（apiKey），无需 & 连接
4. 对最终字符串进行 MD5 加密，取 32 位小写十六进制
请求参数
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
mchId |
是 | string | 商户号 |
name |
是 | string | 真实姓名 |
idCard |
是 | string | 身份证号码 |
sign |
是 | string | 签名 |
reqTime |
否 | string | 请求时间戳（毫秒） |
响应示例
{"code": 0, "msg": "success", "data": {"result": 1, "reason": ""}}
错误码参照 / Error Codes
| code | 说明 |
|---|---|
| 0 | 请求成功 |
| -1 | 请求失败（msg 中包含具体原因） |
| 1001 | 参数缺失或格式错误 |
| 1002 | 签名校验失败 |
| 1003 | 商户不存在或已禁用 |
| 1004 | 账户余额不足 |
| 1005 | QPS 超限 |
| 2001 | 上游接口暂不可用 |
| 2002 | 产品库存不足 |
订单状态说明
| status | 含义 | 说明 |
|---|---|---|
| 1 | 待处理 | 订单已受理，等待处理 |
| 2 | 处理中 | 订单正在充值处理中 |
| 3 | 成功 | 充值成功 |
| 4 | 失败 | 充值失败（余额会自动退回） |
| 5 | 异常 | 订单状态异常，需人工介入 |
示例代码 / Example
Python
import hashlib, time, httpx
MCH_ID = "你的商户号"
API_KEY = "你的API密钥"
def sign(params, api_key):
items = [(k, str(v)) for k, v in params.items() if k != "sign" and v]
items.sort(key=lambda x: x[0])
raw = "&".join(f"{k}={v}" for k, v in items) + api_key
return hashlib.md5(raw.encode()).hexdigest()
params = {
"mchId": MCH_ID,
"reqTime": str(int(time.time() * 1000)),
"mobile": "13800138000",
"amount": "100",
}
params["sign"] = sign(params, API_KEY)
resp = httpx.post("https://api.example.com/v1/id_verify", data=params)
print(resp.json())
cURL
curl -X POST 'https://api.example.com/v1/id_verify' \\ -H 'Content-Type: application/x-www-form-urlencoded' \\ -d 'mchId=你的商户号&reqTime=1694880000000&mobile=13800138000&amount=100&sign=签名'