商户基本信息修改¶

已完成基本信息入驻的商户若信息填写有误或需变更，调用此接口。支持修改商户的基本资料、银行卡信息、结算和取现配置信息。

请求参数¶

请求地址

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

公共请求参数

请求报文头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	固定值产品编号
huifu_id	商户汇付Id	String	Y	18	入驻时返回的huifuid
short_name	商户简称	String	N	64	企业商户填写
license_validity_type	营业执照有效期类型	String	N	1	企业商户填写 1:长期有效 0:非长期有效
license_begin_date	营业执照有效期开始日期	String	N	8	企业商户填写 yyyyMMdd
license_end_date	营业执照有效期截止日期	String	N	8	企业商户填写 yyyyMMdd
reg_prov_id	注册省	String	N	6	企业商户填写六位地区码 ,如修改，需要级联修改省市区
reg_area_id	注册市	String	N	8	企业商户填写六位地区码 ,如修改，需要级联修改省市区
reg_district_id	注册区	String	N	12	企业商户填写六位地区码 ,如修改，需要级联修改省市区
reg_detail	注册详细地址	String	N	255	企业商户填写
legal_name	法人姓名	String	C	32	配置对私结算必填
legal_cert_type	法人证件类型	String	C	2	配置对私结算必填 00:身份证 01:护照 02:军官证 03:士兵证 04:回乡证 05:户口本 06:外国护照 07:其他 08:暂住证 09:警官证 10:文职干部证 11:港澳同胞回乡证
legal_cert_no	法人证件号码	String	C	32	配置对私结算必填
legal_cert_validity_type	法人证件有效期类型	String	C	1	配置对私结算必填 1:长期有效 0:非长期有效
legal_cert_begin_date	法人证件有效期开始日期	String	C	8	配置对私结算必填 yyyyMMdd
legal_cert_end_date	法人证件有效期截止日期	String	C	8	配置对私结算必填，法人证件有效期类型非长期有效必填 yyyyMMdd
prov_id	经营省	String	N	6	六位地区码 ,如修改，需要级联修改省市区
area_id	经营市	String	N	8	六位地区码 ,如修改，需要级联修改省市区
district_id	经营区	String	N	12	六位地区码 ,如修改，需要级联修改省市区
detail_addr	经营详细地址	String	N	256
contact_name	联系人姓名	String	N	128
contact_mobile_no	联系人手机号	String	N	11
contact_email	联系人电子邮箱	String	N	32
service_phone	客服电话	String	N	32
receipt_name	小票名称	String	N	50
mcc	所属行业（MCC）	String	N	4	银联MCC编码
card_info	卡信息	CardInfo	N		JSON对象
cash_config	取现配置列表	List	N		JSON列表卡信息有值时，取现配置、结算配置必须二选一
settle_config	结算配置	SettleConfig	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号文新增字段）
modify_apply_pic	变更申请表文件	String	N	64	上传文件时返回的文件id;变更商户简称、小票名称，联系人信息，地址信息，法人信息，营业执照信息、账户信息时，需要提交变更申请表。变更申请表模板下载（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	C	8	对公结算时必填；对私结算时非必填，参考：银行编码
branch_code	支行联行号	String	C	12	对公时必传,参考：银行支行编码
branch_name	支行名称	String	C	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	格式：yyyyMMdd;证件类型长期有效可不填
mp	银行卡绑定手机号	String	N	11
reg_acct_pic	开户许可证	String	C	128	企业商户填写
legal_cert_front_pic	法人身份证正面	String	C	128	企业商户填写
legal_cert_back_pic	法人身份证反面	String	C	128	企业商户填写
comp_pic1	公司照片一	String	C	128	企业商户填写
comp_pic2	公司照片二	String	C	128	企业商户填写
comp_pic3	公司照片三	String	C	128	企业商户填写
settle_card_front_pic	结算卡正面	String	C	128	对私结算必填
settle_card_back_pic	结算卡反面	String	C	128	对私结算必填
settle_cert_front_pic	结算人身份证正面	String	C	128	对私结算必填
settle_cert_back_pic	结算人身份证反面	String	C	128	对私结算必填

cash_config(取现配置列表)

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

settle_config(结算配置)

参数	中文名	类型	必填	最大长度	说明
settle_status	状态	String	Y	1	1:开通 0:关闭
settle_cycle	结算周期	String	Y	2	T1:下个工作日到账;D1:下个自然日到账
min_amt	起结金额	String	N	18	整数最多14位，小数最多两位
remained_amt	留存金额	String	N	18	整数最多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\":\"2020051313355816158test001\",\"req_date\":\"20200513\",\"product_id\":\"ZDTEST\",\"huifu_id\":\"6666000003124346\",\"upper_huifu_id\":\"6666000003078903\",\"short_name\":\"集成企业商户2654\",\"license_validity_type\":\"1\",\"license_begin_date\":\"19900101\",\"license_end_date\":\"29090101\",\"reg_prov_id\":\"150000\",\"reg_area_id\":\"310100\",\"reg_district_id\":\"150404\",\"reg_detail\":\"台州市宜山路700解放2路146\",\"legal_name\":\"王测试\",\"legal_cert_type\":\"00\",\"legal_cert_no\":\"110101199003075998\",\"legal_cert_validity_type\":\"0\",\"legal_cert_begin_date\":\"19900101\",\"legal_cert_end_date\":\"29900101\",\"contact_name\":\"王测试\",\"contact_mobile_no\":\"18666666666\",\"contact_email\":\"qq12324@qq.com\",\"receipt_name\":\"w我要14称\",\"mcc\":\"5411\",\"service_phone\":\"4008200000\",\"prov_id\":\"150000\",\"area_id\":\"150400\",\"district_id\":\"150404\",\"detail_addr\":\"徐州市徐汇区宜山路7521号\",\"card_info\":{\"card_type\":\"1\",\"card_name\":\"司马测试\",\"card_no\":\"6226090219298748\",\"bank_code\":\"01030000\",\"branch_code\":\"103290040169\",\"branch_name\":\"中国农业银行股份有限公司安徽省马当路支行\",\"prov_id\":\"310000\",\"area_id\":\"310100\",\"cert_type\":\"00\",\"cert_no\":\"150404199001200073\",\"cert_validity_type\":\"0\",\"cert_begin_date\":\"19900101\",\"cert_end_date\":\"29200101\",\"mp\":\"18221987178\"},\"cash_config\":[{\"switch_state\":\"1\",\"cash_type\":\"D0\",\"fix_amt\":\"4.00\",\"fee_rate\":\"5.50\"}],\"settle_config\":{\"settle_status\":\"1\",\"settle_cycle\":\"D1\",\"min_amt\":\"3.00\",\"remained_amt\":\"22.00\",\"settle_abstract\":\"凉了就自己热起来\",\"out_settle_flag\":\"2\",\"out_settle_huifuid\":\"6666000003078904\",\"fixed_ratio\":\"2.00\"},\"async_return_url\":\"https://www.baiduuii.com\"}",
    "sys_id": "ssproxy_dev",
    "sign": "PwMABqR1CMo1appCC+MiNTF/JAfgOleKKKO41ZVePMzGRUETazcO4nH6V5tBbsg1/Y0gFmme3FOnZ5kMr9uv/COlMA4P3fnOz+RmocllkhKwJA+juAiS79KTURPe+AEjXHw1JYq9eSqXx6ycELbTyb+3l7HVfHbz88pKgTjqNZ4=",
    "sign_type": "RSA2"
}

响应示例¶

{"data":"{\"sub_resp_code\":\"90000000\",\"apply_no\":\"2020051300116601\",\"huifu_id\":\"6666000003124346\",\"sub_resp_desc\":\"审核中\"}","resp_code":"10000","resp_desc":"成功调用","sign":"BqIaXVAo6q38hztY6uxcLTTjptoOAZfec2Oy0z0a55qN8uCqNIHHB0h//Y2pYUQ2NZLOZSfaupfRTmD6g92tFsFdo6AjyQnIutpxwVA6VdRDyhfQ/tUoAkfeMZZsUwdClR/wnlQldrwewi0/R31zmOvEcu+VWpmHZeWiuZp4fQQ="}

接口调用示例¶

Demo参考