个人商户基本信息入驻

服务商通过此接口在汇付为小微商户进行基本信息开户。传入小微商户基本资料和图片资料，开通汇付账号，为商户绑定银行卡、配置结算和取现等功能。若选择发送短信给商户，将会发送账号、密码、控台地址短信至商户联系人手机号。

请求参数

  • 请求地址

https://spin.cloudpnr.com/ssproxy/indvMerReg

  • 公共请求参数

请求报文头HEADER - 「接口规则-参数规定-报文头」 ，请求报文体BODY - 「接口规则-参数规定-报文体」 ，响应报文体 - 「接口规则-参数规定-响应报文体」

  • 请求参数(data)
参数 中文名 类型 必填 最大长度 说明
req_seq_id 请求流水号 String Y 32 请求流水号
req_date 请求时间 String Y 8 请求时间YYYYMMDD
upper_huifu_id 渠道商汇付Id String Y 18 汇付分配的渠道商号
reg_name 商户名 String Y 32 个人商户就是本人姓名
product_id 产品编号 String N 32 固定值产品编号
prov_id 经营省 String Y 6 六位地区码
area_id 经营市 String Y 8 六位地区码
district_id 经营区 String Y 12 六位地区码
detail_addr 经营详细地址 String Y 256  
contact_name 联系人姓名 String Y 128  
contact_mobile_no 联系人手机号 String Y 11  
contact_email 联系人电子邮箱 String Y 32  
sms_send_flag 是否发送短信通知商户 String N 1 默认否，1：短信通知
login_name 管理员账号 String N 32 自定义值，必须全网唯一；为空，系统默认生成，作为控台的登陆用户名POS机的登陆用户名
card_info 卡信息 Object Y   JSON对象
cash_config 取现配置列表 List N   JSON列表
settle_config 结算配置 Object N   JSON对象
async_return_url 异步通知地址 String N 128 格式：virgo://消息接收地址，如：virgo://http://service.example.com/to/path。为空不推送审核消息。
settle_agree_pic D1结算协议图片文件 String N 128  
short_name 商户简称 String N 64  
mer_url 商户主页URL String N 256 商户主页URL （259号文新增字段）
mer_icp 商户ICP备案编号 String N 50 商户ICP备案编号 （259号文新增字段）

card_info(卡信息)

参数 中文名 类型 必填 最大长度 说明
card_name 卡户名 String Y 128 银行卡对应的户名
card_no 卡号 String Y 32 银行卡号
prov_id 银行所在省 String Y 6 六位地区码
area_id 银行所在市 String Y 6 六位地区码
bank_code 银行号 String Y 8 参考： 银行编码
cert_type 持卡人证件类型 String Y 2 00:身份证 01:护照 02:军官证 03:士兵证 04:回乡证 05:户口本 06:外国护照 07:其他 08:暂住证 09:警官证 10:文职干部证 11:港澳同胞回乡证
cert_no 持卡人证件号码 String Y 32  
cert_validity_type 持卡人证件有效期类型 String Y 1 1:长期有效 0:非长期有效
cert_begin_date 持卡人证件有效期（起始） String Y 8  
cert_end_date 持卡人证件有效期（截止） String N 8 证件类型长期有效可不填
mp 银行卡绑定手机号 String Y 11  

cash_config(取现配置列表)

参数 中文名 类型 必填 最大长度 说明
cash_type 业务类型 String N 2 D0:当日到账;T1:下个工作日到账;D1:下个自然日到账
fix_amt 提现手续费（固定/元） BigDecimal N 14,2 开通提现业务时必须填写一种收费方式
fee_rate 费率（百分比/%） BigDecimal N 3,2 开通提现业务时必须填写一种收费方式

settle_config(结算配置)

参数 中文名 类型 必填 最大长度 说明
settle_cycle 结算周期 String Y 2 T1:下个工作日到账;D1:下个自然日到账
min_amt 起结金额 String N 14,2 整数最多14位，小数最多两位
remained_amt 留存金额 String N 14,2 整数最多14位，小数最多两位
settle_abstract 结算摘要 String N 128 默认为空，如果需要自定义结算打款备注，请使用此字段传入，字段类型为字符串
out_settle_flag 手续费外扣标记 String N 1 1:外扣：结算时，从out_settle_huifuid账户扣手续费 2:内扣：从结算金额中扣手续费
out_settle_huifuid 结算手续费外扣时的汇付ID String N 16 out_settle_flag=1时必填
out_settle_acct_type 结算手续费外扣时的账户类型 String N 2 01-基本户05-充值户不填默认01
fixed_ratio 节假日结算手续费率 String N 16 T1时无意义，D1时节假日按此费率结算;整数最多14位，小数最多两位
settle_batch_no 结算批次号 String N 16 0(0点昨日余额结算批次),300(3点余额结算批次),600(6点余额结算批次),900(9点余额结算批次)

响应参数

  • 同步响应参数(data)
参数 中文名 类型 必填 最大长度 说明
sub_resp_code 业务返回码 String Y 8 业务返回码
sub_resp_desc 业务返回描述 String Y 512 业务返回描述
huifu_id 汇付客户号 String N 18 固定18位 ,汇付分配的商户号
apply_no 申请单号 String N 18 汇付返回商户开户业务申请单号
token_no 取现卡序列号 String N 20 取现业务用到
  • 异步响应参数(data)
参数 中文名 类型 必填 最大长度 说明
sub_resp_code 业务返回码 String Y 8 业务返回码
sub_resp_desc 业务返回描述 String Y 512 业务返回描述
req_seq_id 请求流水号 String Y 32 原请求流水号
req_date 请求时间 String Y 8 原请求时间YYYYMMDD
audit_status 审核结果 String Y 1 Y：审核通过 N：审核拒绝 F：失败
audit_desc 审核描述 String N 512 审核结果描述
product_id 产品编号 String Y 32 固定值产品编号
huifu_id 汇付客户号 String N 18 固定18位 ,汇付分配的商户号
apply_no 申请单号 String N 18 汇付返回商户开户业务申请单号
token_no 取现卡序列号 String N 20 取现业务用到

请求示例

{
    "sys_id":"ssproxy_dev",
    "data":"{\"req_seq_id\":\"rQ2020051301355170197950732415\",\"req_date\":\"20200513\",\"upper_huifu_id\":\"6666000003107730\",\"product_id\":\"MCS\",\"reg_name\":\"企业商户\",\"short_name\":\"企业商户8564\",\"prov_id\":\"310000\",\"area_id\":\"310100\",\"district_id\":\"310104\",\"detail_addr\":\"吉林省长春市思明区解放1路90164567\",\"contact_name\":\"联系人\",\"contact_mobile_no\":\"13111112222\",\"contact_email\":\"jiajia.tang@huifu.com\",\"sms_send_flag\":\"1\",\"login_name\":\"LG20200513013551701979507\",\"async_return_url\":\"virgo://http://192.168.85.157:30031/sspm/testVirgo\",\"card_info\":{\"card_name\":\"陈立健\",\"card_no\":\"6225682141000002951\",\"prov_id\":\"310000\",\"area_id\":\"310100\",\"bank_code\":\"01030000\",\"cert_type\":\"00\",\"cert_no\":\"321084198912066512\",\"cert_validity_type\":\"1\",\"cert_begin_date\":\"20121201\",\"cert_end_date\":\"20301201\",\"mp\":\"13700000214\"},\"cash_config\":[{\"cash_type\":\"D0\",\"fix_amt\":\"1.00\",\"fee_rate\":\"\"},{\"cash_type\":\"D1\",\"fix_amt\":\"\",\"fee_rate\":\"10.00\"}],\"settle_config\":{\"settle_cycle\":\"D1\",\"min_amt\":\"1.00\",\"remained_amt\":\"2.00\",\"settle_abstract\":\"abstract\",\"out_settle_flag\":\"2\",\"out_settle_huifuid\":\"\",\"fixed_ratio\":\"5.00\"}}",
    "sign":"CwPVQzbFA3I1fOExMslMO48bi2nyVZtGhBGhasDRmvy8AHDtSL/Fl92z3fvma/J5Yiq2uuLK4+QEGDfmnEVHfZJs74mlW17pzjQE5VxJrV4Sr98pS0KsAzCH5C85jqsKokNGm3J2m3NI3Kakqc6lww8nNfGBPmXohrN6CgHxCks=",
    "sign_type":"RSA2"
}
  • java

响应示例

{"data":"{\"sub_resp_code\":\"00000000\",\"huifu_id\":\"6666000003149748\",\"sub_resp_desc\":\"成功\"}","resp_code":"10000","resp_desc":"成功调用","sign":"J2xU8KlXqlvntSVTKl7v2RIX+ui5wkSWY0X4zsN4aIsx/jhUc6GSY8BwVVnjadaDh6FjvuQ1andEquRWFxAQPReNNhwii7YHKPYDCYlu8quMAdukyi+Xu+UXmohJNoUfPo8md/oNCuqNWGqEd44tvcflJs8Lh8rm61xXFcFPnOI="}

接口调用示例

Demo参考