银行卡信息鉴权

开发中

测试环境

POST

/EasypayMPSystem/VerifyBankServet

最后修改时间：2023-04-25 05:11:24

责任人：谭得红

此接口为银行卡信息要素鉴权接口，支持2/3/4要素信息验证。银行卡信息要素为：银行卡号、持卡人姓名、银行卡预留手机号、持卡人证件号，其中银行卡号、持卡人姓名是必传要素信息。
一些特殊卡号，由于发卡行原因，无法进行鉴权，经过鉴权系统时，不会进行核验，这种情况下，相关的返回字段会有说明。具体卡bin信息详见附录

请求参数

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-大陆居民身份证）

示例值:

accNo

string

卡号长度 50

可选

示例值:

4367422298584671787

accName

string

必需

持卡人姓名长度 30

示例值:

陈莉莉

sign

string

必需

签名值长度最大100

示例值:

02D31CC8DB6D04DC3330313809A695D6

merId

string

必需

商户编号最大长度50

示例值:

MER021322021600

version

string

必需

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

示例值:

3.0

channelId

string

必需

渠道编号最大长度50

示例值:

616161622021600

mobileNo

string

必需

预留手机号长度11位

示例值:

13800001111,,,

accType

string

可选

卡类型：00-其他；01-借记卡；02-信用卡；03-预付费卡

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200成功

application/json

Body

resultMsg

string

应答码描述

可选

<= 128 字符

sign

string

签名值

可选

<= 100 字符

merorderId

string

平台订单号

可选

<= 50 字符

verifyState

enum<string>

鉴权结果状态

可选

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

<= 2 字符

枚举值:

000106101125

resultCode

enum<string>

应答码

必需

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

<= 2 字符

枚举值:

00010306092530314041425164949698AAA0AB

示例

{
  "resultCode": "00",
  "resultMsg": "请求成功",
  "merorderId": "1234567890",
  "sign": "377F2CC39E27424BE3948F1014368F16",
  "verifyState": "01"
}

修改于 2023-04-25 05:11:24

订单拉取-暂时没对外调试

通讯运营商信息鉴权