身份证实名认证二要素未返照
1.修订记录
修订 |
日期 |
说明 |
作者 |
V0.1 |
2017/05/17 |
新接口参数定义 |
莫尚校 |
V0.2 |
2018/05/25 |
补充shopdate参数 |
黄国强 |
V0.3 |
2021/12/27 |
支持国密 |
王晶 |
2.接口说明
(1)场景说明
1、调用接口进行实名认证
2、需要传入姓名和身份证号,成功不返回照片
(2)接口说明
1、全国身份证实名认证二要素未返照下单接口
3.请求地址
4.请求参数说明
4.1 公共请求参数
参数 |
类型(字节长度) |
必填 |
参数说明 |
method |
String(1,128) |
Y |
接口名称 固定值 ysepay.authenticate.id.card |
partner_id |
String(1,20) |
Y |
在银盛支付开设的服务商商户号,请联系客户经理提供 |
timestamp |
String(1,19) |
Y |
发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" 示例值:2014-07-24 03:07:50 |
charset |
String(1,10) |
Y |
商户网站使用的编码格式,如UTF-8、GBK、GB2312等,默认值 GBK |
sign_type |
String(1,10) |
Y |
报文签名算法,RSA/SM |
sign |
String(1,256) |
Y |
签名字符串,再用Base64编码 |
version |
String(1,3) |
Y |
接口版本3.0 当前版本:3.0 |
biz_content |
String |
Y |
业务请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递 |
4.2 业务请求参数
参数名biz_content,值为一个json格式对象,下面列表描述json对象的值
参数 |
类型(字节长度) |
必填 |
参数说明 |
out_trade_no |
String(1,32) |
Y |
商户系统生成的订单号,生成规则前8位必须为交易日期,如20180525,范围跨度支持包含当天在内的前后一天,且只能由大小写英文字母、数字、下划线及横杠组成 示例值:201805256843192280647118 |
shopdate |
String(8,8) |
Y |
商户系统的交易发生日期格式yyyyMMdd 示例值:20180525 |
name |
String(1,100) |
Y |
实名认证姓名 |
id_card |
String(50) |
Y |
身份证号码,必须符合身份证标准规范(如果签名方式为RSA,则用DES加密,密钥为商户号前8位,不足8位在商户号前补空格;如果签名方式为SM,则用SM加密) |
5.响应参数说明
银盛支付对商户的请求数据处理完成后,会将处理的结果数据同步回执给商户。
请注意:银盛后期会对返回参数保留扩展的权力,扩展方式为新增参数但不会删除参数,请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。
5.1 公共响应参数
参数 |
类型(字节长度) |
必填 |
参数说明 |
sign |
String |
Y |
签名字符串,Base64编码 |
ysepay_authenticate_id_card_response |
String |
Y |
业务响应参数的集合,最大长度不限 |
5.2 业务响应参数
银盛支付对商户的请求数据受理完成后,会将处理的结果数据同步回执给商户。
请注意:银盛后期会对返回参数保留扩展的权力,扩展方式为新增参数但不会删除参数,请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。
参数 |
类型(字节长度) |
必填 |
参数说明 |
code |
String |
Y |
响应代码 |
msg |
String |
Y |
响应代码描述 |
out_trade_no |
String(1,32) |
Y |
商户系统生成的订单号 |
trade_no |
String(16) |
N |
银盛支付交易流水号 |
name |
String(1,100) |
Y |
实名认证姓名 |
id_card |
String(50) |
Y |
身份证号码 |
fee |
Number(15) |
N |
参考手续费,单位为:RMB Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。 |
order_status |
String(32) |
Y |
实名认证目前所处的状态。实名认证状态的值: SUCCESS|FAILURE 示例值:附录8.2 |
order_status_description |
String(256) |
N |
状态描述,当order_status_description 为FAILURE时,该字段是实名认证失败原因描述。该参数最长为128个汉字。 |
6.样例
无
7.附录
7.1 实名认证错误码
错误码 |
错误描述 |
解决方案 |
AQC.SYSTEM_ERROR |
系统错误 |
请调用查询接口查询订单状态 |
ACQ.INVALID_PARAMETER |
参数无效 |
检查请求参数,修改后重新发起请求 |
ACQ.PARAM_ERROR |
参数错误 |
检查请求参数,修改后重新发起请求 |
ACQ.RISK_ERROR |
风控检查异常 |
请检查风控是否有异常,然后再重新发起 |
ACQ.SYSTEM_BUSY |
系统繁忙 |
请稍后再试,如还有问题,请联系银盛 |
ACQ.RETURN_ERROR |
实名认证回执异常 |
请稍后再试,如还有问题,请联系银盛 |
7.2 实名认证状态
枚举名称 |
枚举说明 |
SUCCESS |
实名认证成功 |
FAILURE |
实名认证失败 |