公安信息鉴权

开发中

测试环境

POST

/EasypayMPSystem/VerifyPoliceServet

最后修改时间：2023-04-25 07:16:15

责任人：谭得红

此接口为公安要素信息鉴权接口。公安要素信息为：姓名、证件号、证件类型。

请求参数

Body 参数application/x-www-form-urlencoded

termId

string

必需

终端编号长度最大 50

示例值:

TE021600

tradeTrace

string

必需

商户订单号长度最大 50 控制在50位长度以内，确保在请求接口的系统中全局唯一；可以包含数字与字母；不能包含其他特殊字符

示例值:

ts1682215617407

certNo

string

证件号长度20

必需

示例值:

371325198612060982

certType

string

可选

证件类型长度2 枚举类型：00-其他；01-大陆居民身份证，特别说明：目前只支持大陆居民身份证信息（01-大陆居民身份证）

示例值:

accName

string

姓名长度 30

必需

示例值:

陈莉莉

sign

string

必需

签名值长度最大100

示例值:

02D31CC8DB6D04DC3330313809A695D6

merId

string

必需

商户编号最大长度50

示例值:

MER021322021600

version

string

必需

版本号最大长度10 默认值：3.0

示例值:

3.0

channelId

string

必需

渠道编号最大长度50

示例值:

616161622021600

validBegin

string

可选

有效开始日期 8位长度，公安四要素鉴权时必填

validEnd

string

可选

有效结束日期 8位长度，公安四要素鉴权时必填，长期情况下为”长期”

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-test.eycard.cn:9443/EasypayMPSystem/VerifyPoliceServet' \
--data-urlencode 'termId=TE021600' \
--data-urlencode 'tradeTrace=ts1682215617407' \
--data-urlencode 'certNo=371325198612060982' \
--data-urlencode 'certType=01' \
--data-urlencode 'accName=陈莉莉' \
--data-urlencode 'sign=02D31CC8DB6D04DC3330313809A695D6' \
--data-urlencode 'merId=MER021322021600' \
--data-urlencode 'version=3.0' \
--data-urlencode 'channelId=616161622021600' \
--data-urlencode 'validBegin=' \
--data-urlencode 'validEnd='

返回响应

🟢200成功

application/json

Body

resultCode

enum<string>

应答码

必需

应答码
枚举值：
00-成功；
01-系统错误或异常；
03-商户级别的错误请确定请求信息（渠道编号/商户编号/终端编号）是否有效；
06-错误/失败；
09-系统配置有误请确定系统功能配置是否正确；
25-找不到相关记录；
30-参数有误字段级别的错误，确定上送报文字段是否正确；
31-验证码错误；
40-请求的功能不支持请确定该功能是否支持；
41-查不到数据；
42-无效的开户信息确定开户信息是否真实有效；
51-余额不足；
64-超限额；
94-订单号重复；
96-系统异常；
98-系统超时或异常；
AA-状态未确认/请求正在处理中/有缺陷的成功；
A0-签名错误检查签名数据、签名密钥是否正确；
AB-企业查询异步方式返回根据上传的通知查看通知结果，或相同数据再次请求；

<= 2 字符

枚举值:

00010306092530314041425164949698AAA0AB

resultMsg

string

应答码描述

可选

应答码描述

<= 128 字符

sign

string

签名值

可选

签名值

<= 100 字符

merorderId

string

平台订单号

可选

平台订单号

<= 50 字符

verifyState

enum<string>

鉴权结果状态

可选

鉴权结果状态状态说明：00-鉴权信息一致；01-鉴权信息不一致；06-鉴权验证受限；10-信息不存在风险；11-信息存在风险；25-未找到相关资料信息特别说明：verifyState=06：银行卡信息验证受限：某些发卡行所属银行返回无法验证，或者对应其发行卡行验证功能未开通；通讯运营商验证受限：新办的卡可能没有更新到总部，也存在空号销号返回认证受限的情况，要看具体的情况。公安信息验证受限：①现役或刚退役的军人；② 刚上大学或刚毕业的大学生；③正在迁移户口或者近期迁移户口；④工作调动导致户口有迁移； ⑤发生更名导致户口有变动；⑥地方向中心上传时数据缺失。

>= 2 字符<= 2 字符

枚举值:

000106101125

示例值:

示例

{
  "resultCode": "00",
  "resultMsg": "string",
  "sign": "string",
  "merorderId": "string",
  "verifyState": "00"
}

修改于 2023-04-25 07:16:15

通讯运营商信息鉴权

风险信息鉴权