银行卡账户类型实名认证

1.修订记录

1、根据银行卡，手机号，账户类型等要素做实名认证

1、银行卡账户类型实名认证下单接口

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

参数	类型(字节长度）	必填	参数说明
method	String(1,128)	Y	接口名称固定值 ysepay.authenticate.bankaccounttype
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，范围跨度支持包含当天在内的前后一天，且只能由大小写英文字母、数字、下划线及横杠组成
shopdate	String(8,8)	Y	商户系统的交易发生日期格式yyyyMMdd 示例值：20180525
bank_account_name	String(1,100)	Y	实名认证姓名
bank_account_no	String(15，19)	Y	银行帐号，支持对公对私
bank_mobile	String(11)	Y	银行预留手机号码
id_card	String(50)	Y	证件号码，目前只支持身份证(如果签名方式为RSA，则用DES加密，密钥为商户号前8位，不足8位在商户号前补空格；如果签名方式为SM，则用SM加密)
bank_accounttype	String（1）	Y	银行卡账户类型 1：一类账户，2：二类账户，3：三类账户

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

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

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

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

参数	类型(字节长度）	必填	参数说明
code	String	Y	响应代码
msg	String	Y	响应代码描述
out_trade_no	String(1,32)	Y	商户系统生成的订单号
trade_no	String(16)	N	银盛支付交易流水号
fee	Number(15)	N	参考手续费,单位为：RMB Yuan。取值范围为[0.01，100000000.00]，精确到小数点后两位。
bank_account_name	String(1,100)	N	实名认证姓名
bank_account_no	String(15，19)	Y	银行帐号，支持对公对私
bank_mobile	String(11)	N	银行预留手机号码
id_card	String(50)	N	证件号码，目前只支持身份证(非加密)
bank_accounttype	String（1）	N	银行卡账户类型 1：一类账户，2：二类账户，3：三类账户
order_status	String（32）	Y	实名认证目前所处的状态。实名认证状态的值： SUCCESS｜FAILURE具体详情看下文中的1.4实名认证状态详解
order_status_description	String（256)	N	状态描述，当order_status_description 为FAILURE时，该字段是实名认证失败原因描述。该参数最长为128个汉字。

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