银行卡实名认证二要素(精准)

1.修订记录

修订	日期	说明	作者
V0.1	2019/01/31	新接口参数定义	邓鑫
V0.2	2021/12/27	支持国密	王晶

1、只需要传入银行帐号，实名认证姓名

1、银行卡实名认证二要素下单接口(精准)

环境	HTTPS请求地址
正式环境	https://openapi.ysepay.com/gateway.do

参数	类型(字节长度）	必填	参数说明
method	String(1,128)	Y	接口名称固定值 ysepay.authenticate.two.key.element.precise
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	业务请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递

参数名biz_content,值为一个json格式对象，下面列表描述json对象的值

参数	类型(字节长度）	必填	参数说明
out_trade_no	String(1,32)	Y	商户系统生成的订单号，生成规则前8位必须为交易日期，如20180525，范围跨度支持包含当天在内的前后一天，且只能由大小写英文字母、数字、下划线及横杠组成示例值：201805256843192280647118
shopdate	String(8,8)	Y	商户系统的交易发生日期格式yyyyMMdd 示例值：20180525
bank_account_no	String(15，19)	Y	银行帐号
bank_account_name	String(1,100)	Y	实名认证姓名

银盛支付对商户的请求数据处理完成后，会将处理的结果数据同步回执给商户。

请注意：银盛后期会对返回参数保留扩展的权力，扩展方式为新增参数但不会删除参数，请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。

参数	类型(字节长度）	必填	参数说明
sign	String	Y	签名字符串，Base64编码
ysepay_authenticate_two_key_element_precise_response	String	Y	业务响应参数的集合，最大长度不限

银盛支付对商户的请求数据受理完成后，会将处理的结果数据同步回执给商户。

参数	类型(字节长度）	必填	参数说明
code	String	Y	响应代码
msg	String	Y	响应代码描述
out_trade_no	String(1,32)	Y	商户系统生成的订单号
trade_no	String(16)	N	银盛支付交易流水号
bank_account_no	String(15，19)	Y	银行帐号
bank_account_name	String(1,100)	N	实名认证姓名
fee	Number(15)	N	参考手续费,单位为：RMB Yuan。取值范围为[0.01，100000000.00]，精确到小数点后两位。
order_status	String（32）	Y	实名认证目前所处的状态。实名认证状态的值： SUCCESS｜FAILURE 示例值：附录7.2
order_status_description	String（256)	N	状态描述，当order_status_description 为FAILURE时，该字段是实名认证失败原因描述。该参数最长为128个汉字。

枚举名称	枚举说明
SUCCESS	实名认证成功
FAILURE	实名认证失败