风险信息鉴权

开发中

测试环境

POST

/EasypayMPSystem/QueryRiskServet

最后修改时间：2025-04-25 01:32:04

责任人：谭得红

根据上送的银行卡号/身份证号/营业执照号来鉴权该商户在支付宝风控系统中是否存在风险。其中营业执照号可为工商注册号、统一社会信用代码。

请求参数

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

termId

string

必需

终端编号长度最大 50

示例值:

TE042500

tradeTrace

string

必需

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

示例值:

ts1682215617407

sign

string

必需

签名值长度最大100

示例值:

02D31CC8DB6D04DC3330313809A695D6

merId

string

必需

商户编号最大长度50

示例值:

MER021323042500

version

string

必需

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

示例值:

3.0

channelId

string

必需

渠道编号最大长度50

示例值:

616161623042500

opt

string

必需

操作类型最大长度50 枚举类型：（“verifyRiskBankcard”:银行卡卡号；“verifyRiskIdcard”：身份证号；“verifyRiskBusinessLicense”：营业执照号）

示例值:

verifyRiskBankcard

riskNumber

string

必需

操作类型对应的号码最大长度50 银行卡号/身份证号/营业执照值

示例值:

6214000000000001

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-test.eycard.cn:9443/EasypayMPSystem/QueryRiskServet' \
--data-urlencode 'termId=TE042500' \
--data-urlencode 'tradeTrace=ts1682215617407' \
--data-urlencode 'sign=02D31CC8DB6D04DC3330313809A695D6' \
--data-urlencode 'merId=MER021323042500' \
--data-urlencode 'version=3.0' \
--data-urlencode 'channelId=616161623042500' \
--data-urlencode 'opt=verifyRiskBankcard' \
--data-urlencode 'riskNumber=6214000000000001'

返回响应

🟢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"
}

修改于 2025-04-25 01:32:04

公安信息鉴权

短信鉴权