企业商户基本信息入驻

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

请求参数

  • 请求地址

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

  • 公共请求参数

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

  • 请求参数(data)
参数 中文名 类型 必填 最大长度 说明
req_seq_id 请求流水号 String Y 32 请求流水号
req_date 请求时间 String Y 8 请求时间YYYYMMDD
upper_huifu_id 渠道商汇付Id String Y 18 汇付分配的渠道商号
product_id 产品编号 String Y 32 固定值产品编号
reg_name 商户名称 String Y 50 当为汉字时，以2个字符计算
short_name 商户简称 String Y 64  
ent_type 公司类型 String Y 1 1:政府机构 2:国营企业 3:私营企业 4:外资企业 5:个体工商户 7:事业单位
license_code 营业执照编号 String Y 18  
license_validity_type 营业执照有效期类型 String Y 1 1:长期有效 0:非长期有效
license_begin_date 营业执照有效期开始日期 String Y 8 yyyyMMdd
license_end_date 营业执照有效期截止日期 String N 8 yyyyMMdd
reg_prov_id 注册省 String Y 6 六位地区码
reg_area_id 注册市 String Y 8 六位地区码
reg_district_id 注册区 String Y 12 六位地区码
reg_detail 注册详细地址 String Y 255 当为汉字时，以2个字符计算
legal_name 法人姓名 String Y 32  
legal_cert_type 法人证件类型 String Y 2 00:身份证 01:护照 02:军官证 03:士兵证 04:回乡证 05:户口本 06:外国护照 07:其他 08:暂住证 09:警官证 10:文职干部证 11:港澳同胞回乡证
legal_cert_no 法人证件号码 String Y 32  
legal_cert_validity_type 法人证件有效期类型 String Y 1 1:长期有效 0:非长期有效
legal_cert_begin_date 法人证件有效期开始日期 String Y 8 yyyyMMdd
legal_cert_end_date 法人证件有效期截止日期 String Y 8 yyyyMMdd
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  
service_phone 客服电话 String N 32  
sms_send_flag 是否发送短信通知商户 String N 1 默认否, 1：短信通知联系人手机号
login_name 管理员账号 String N 32 自定义值，必须全网唯一；作为控台的登陆用户名POS机的登陆用户名；为空不生成。
busi_type 经营类型 String Y 1 1:实体 2:虚拟
receipt_name 小票名称 String Y 50 可以作为POS小票的名称
mcc 所属行业（MCC） String Y 4 银联MCC编码
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  
mer_en_name 商户英文名称 String N 256 商户英文名称（259号文新增字段）
mer_url 商户主页URL String N 256 商户主页URL （259号文新增字段）
mer_icp 商户ICP备案编号 String N 50 商户ICP备案编号 （259号文新增字段）
license_type 营业执照类型 String N 32 NATIONAL_LEGAL:营业执照,NATIONAL_LEGAL_MERGE:营业执照(多证合一)（默认），INST_RGST_CTF:事业单位法人证书 （259号文新增字段）
open_licence_no 开户许可证核准号 String N 32 开户许可证核准号或者是基本存款账户编号有条件必填；当注册或经营地址为如下地区时此字段必填涉及地区；浙江，海南，重庆，河南，江苏，宁波市，黑龙江，吉林，湖南， 贵州，陕西，湖北

card_info(卡信息)

参数 中文名 类型 必填 最大长度 说明
card_type 卡类型 String Y 1 0:对公 1：对私法人 2：对私非法人
card_name 卡户名 String Y 128 银行卡对应的户名
card_no 卡号 String Y 32 银行卡号
prov_id 银行所在省 String Y 6 六位地区码
area_id 银行所在市 String Y 6 六位地区码
bank_code 银行号 String N 8 对公结算时必填；对私结算时非必填，参考： 银行编码
branch_code 支行联行号 String N 12 对公时必传,参考：银行支行编码
branch_name 支行名称 String N 64 对公时必传
cert_type 持卡人证件类型 String N 2 00:身份证 01:护照 02:军官证 03:士兵证 04:回乡证 05:户口本 06:外国护照 07:其他 08:暂住证 09:警官证 10:文职干部证 11:港澳同胞回乡证 （对私结算必填）
cert_no 持卡人证件号码 String N 32 （对私结算必填）
cert_validity_type 持卡人证件有效期类型 String N 1 1:长期有效 0:非长期有效 （对私结算必填）
cert_begin_date 持卡人证件有效期（起始） String N 8 YYYYMMDD （对私结算必填）
cert_end_date 持卡人证件有效期（截止） String N 8 证件类型长期有效可不填 （对私结算必填）
mp 银行卡绑定手机号 String N 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 取现业务用到

请求示例

{
    "data": "{\"req_seq_id\":\"rQ202005135093636721301\",\"req_date\":\"20200513\",\"upper_huifu_id\":\"6666000003083511\",\"product_id\":\"ZDTEST\",\"reg_name\":\"集成企业商户9190\",\"short_name\":\"企业商户5694\",\"ent_type\":\"1\",\"license_code\":\"20200513509363672\",\"license_validity_type\":\"0\",\"license_begin_date\":\"20200401\",\"license_end_date\":\"20300101\",\"reg_prov_id\":\"350000\",\"reg_area_id\":\"350200\",\"reg_district_id\":\"350203\",\"reg_detail\":\"吉林省长春市思明区解放2路61686340\",\"legal_name\":\"陈立健\",\"legal_cert_type\":\"00\",\"legal_cert_no\":\"321084198912066512\",\"legal_cert_validity_type\":\"1\",\"legal_cert_begin_date\":\"20121201\",\"legal_cert_end_date\":\"20301201\",\"prov_id\":\"310000\",\"area_id\":\"310100\",\"district_id\":\"310104\",\"detail_addr\":\"吉林省长春市思明区解放1路73292079\",\"contact_name\":\"联系人\",\"contact_mobile_no\":\"13111112222\",\"contact_email\":\"jeff.peng@huifu.com\",\"service_phone\":\"021-121111221\",\"sms_send_flag\":\"1\",\"login_name\":\"LG20200513509363672\",\"busi_type\":\"1\",\"receipt_name\":\"盈盈超市\",\"mcc\":\"5411\",\"async_return_url\":\"http://192.168.85.157:30031/sspm/testVirgo\",\"card_info\":{\"card_type\":\"1\",\"card_name\":\"陈立健\",\"card_no\":\"6225682141000002951\",\"prov_id\":\"310000\",\"area_id\":\"310100\",\"bank_code\":\"01030000\",\"branch_code\":\"103290040169\",\"branch_name\":\"中国农业银行股份有限公司上海马当路支行\",\"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\":\"0.11\"}],\"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\"}}",
    "sys_id": "ssproxy_dev",
    "sign": "QpjtNKeiQa06hoL3TXbqfJqGq3tDLy+zHLn+z1XHantqAEbws5M9XMRSskU3GXekGXmiVFN59KXPOc6phm8/j3ibP3beVPIjgesNz9dozTiamcEnILDgWlYooeNUu8JsIHdyQJtgXdrtN0dEVtQDVjWVMu4hfGzz6+jcWQvhZ4Y=",
    "sign_type": "RSA2"
}

响应示例

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

接口调用示例

Demo参考