云商服钱包注册
1、修订记录
| 修订记录 | 日期 | 说明 |
|---|---|---|
| 1.0 | 2026.10.30 | 钱包用户注册(个人/企业), 同步受理 异步处理. |
2、业务说明
（1）接口说明
钱包用户注册(个人/企业), 同步受理 异步处理.
请求主体类型：application/json
请求方式：POST
3、请求地址
| 环境 | HTTPS请求地址 |
|---|---|
| 测试环境 | https://appdev.ysepay-test.com/openapi/smsc/wallet/register |
| 正式环境 | https://ysgate.ysepay.com/openapi/smsc/wallet/register |
4、请求参数说明
4.1、公共请求参数
| 参数 | 类型(长度） | 必填 | 参数说明 |
|---|---|---|---|
| timeStamp | String | Y | 发送请求的时间，格式"yyyy-MM-dd HH:mm:ss" |
| method | String(128) | Y | 接口名称，固定值：smsc.wallet.register |
| charset | String(10) | Y | 请求使用的编码格式，如utf-8,gbk,gb2312等,固定为utf-8 |
| sign | String | Y | 商户请求参数的签名串（签名算法默认为国密）,详见demo,注意:请用商户私钥进行签名 |
| check | String | Y | 银盛公钥加密随机生成的字符串（key）得到的加密值，详见demo |
| bizContent | String | Y | 业务参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递。注意：需要通过AES以及随机生成的字符串（key）加密业务参数集合，得到bizContent |
| reqId | String | Y | 请求唯一流水号,商户系统唯一，要求32个字符内（最少14个字符），只能是数字、大小写字母_-且在同一个商户号下唯一。最后12位要求格式为"yyMMddHHmmss" 示例值：xy1415220315145602 |
| certId | String | Y | 发起方商户号，服务商在银盛给自己开设的商户号，即可当作发起方商户号，由银盛生成并下发。 注意：不同于子商户号，服务商发展的商户即为子商户号 |
| version | String | Y | 调用的接口版本，固定为：1.0 |
4.2、业务请求参数
（bizContent加密前的json数据明文字符串）
| 参数 | 类型(长度） | 必填 | 参数说明 |
|---|---|---|---|
| sendChannelSerialNo | String | Y | 外部申请流水号(与src联合唯一, 重复请求幂等返回原申请) |
| mobile | String | Y | 签约手机号 |
| recommendMerchantNo | String | Y | 推荐商户号, 用于记录推荐关系. 受理时校验商户存在及发起方与商户的上下级关系 |
| userType | String | Y | 用户类型(与客户系统custFlag码值一致). 1-个人用户(对私); 8-个体户用户(对公); |
| userName | String | Y | 用户名称. 企业钱包填证照名称, 个人填姓名 |
| buzCertType | String | N | 企业证照类型(企业钱包必填, 个人钱包无需传), 码值同商户进件, 与用户类型联动校验: userT |
| buzCertNo | String | N | 企业证照号码(企业钱包必填) |
| buzCertPicNo | String | N | 企业证照图片编号(企业钱包必填), 由通用图片上传接口获取 |
| buzCertAddrProv | String | N | 企业证照地址省编码(企业钱包必填) |
| buzCertAddrCity | String | N | 企业证照地址市编码(企业钱包必填) |
| buzCertAddrArea | String | N | 企业证照地址区县编码(企业钱包必填) |
| buzCertAddr | String | N | 企业证照地址详细地址(企业钱包必填) |
| bankAccountNo | String | Y | 银行账号 |
| bankAccountName | String | Y | 银行账户名 |
| bankObligationMobile | String | N | 银行预留手机号 |
| bankType | String | N | 银行编码(企业钱包必填) |
| bankProvince | String | N | 开户省编码(企业钱包必填), 枚举值同商户进件 |
| bankCity | String | N | 开户市编码(企业钱包必填), 枚举值同商户进件 |
| bankAccountType | String | Y | 银行账户类型. 11-个人借记卡, 13-个人存折, 21-对公借记卡, 23-对公存折, 24-单 |
| crprtnCertName | String | Y | 法人/负责人姓名. 企业钱包填法人, 个人填负责人信息 |
| crprtnCertPicNo | String | Y | 法人/负责人证件人像面图片编号, 由通用图片上传接口获取 |
| crprtnCertNatemblemPicNo | String | Y | 法人/负责人证件国徽面图片编号, 由通用图片上传接口获取 |
| crprtnCertType | String | Y | 法人/负责人证件类型(同商户进件). 00-身份证, 06-国外护照, 07-港澳通行证, 08-台 |
| crprtnCertNo | String | Y | 法人/负责人证件号码 |
| crprtnCertValiTermSrtDt | String | Y | 法人/负责人证件有效期开始, 格式yyyyMMdd |
| crprtnCertValiTermEndDt | String | Y | 法人/负责人证件有效期截止, 格式yyyyMMdd, 长期填99991231 |
| crprtnCertAddr | String | Y | 法人/负责人证件地址详细地址 |
| contractType | String | N | 合同类型. 1-纸质合同, 2-电子合同. 默认电子合同 |
| isSendSignSms | String | N | 是否自动发送签约通知. 1-短信通知, 3-不通知. 默认通知 |
| agreementPicNos | Array | N | 纸质协议图片编号集合(合同类型为纸质合同时必填), 支持多张, 元素为string(图片编号) |
| asyncNotifyUrl | String | Y | 通知回调地址, 接收钱包注册异步通知 |
| remark | String | N | 备注 |
5、响应参数说明
请注意：银盛后期会对返回参数保留扩展的权力，扩展方式为新增参数但不会删除参数，请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。5.1、公共响应参数
| 参数 | 类型(长度） | 必填 | 参数说明 |
|---|---|---|---|
| code | String(5) | Y | 网关响应码，示例值：00000 ，详见网关公共响应码 |
| msg | String(50) | Y | 网关响应码描述 |
| subCode | String | Y | 业务响应码，参见具体的API接口文档 |
| subMsg | String | Y | 业务响应描述 |
| timeStamp | String | Y | 响应时间，格式"yyyy-MM-dd HH:mm:ss" |
| norce | String(128) | Y | 随机参数 |
| sign | String | Y | 响应参数的签名串，详见demo, 注意:请用银盛公钥进行验签 |
| businessData | String | Y | 业务响应参数集合， 注意：银盛网关通过AES加密业务响应参数集合，得到businessData，商户需要对其进行解密，详情请见demo |
5.2、业务响应参数
响应业务参数businessData(json数据)
| 参数 | 类型(长度） | 必填 | 参数说明 |
|---|---|---|---|
| applySerialNo | String | Y | 银盛注册流水号 |
6、业务响应码 网关公共响应码
| 响应码 | 响应码描述 | 解决方案 |
|---|---|---|
| 0000 | 成功 |