直付通-商户入驻

提供直付通商户入驻接口

请求参数

  • 请求地址

https://spin.cloudpnr.com/ssproxy/direct/regZftMerInfo

  • 公共请求参数

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

  • 请求参数(data)
参数 中文名 类型 必填 最大长度 说明
req_seq_id 请求流水号 String Y 128 请求流水号
req_date 请求时间 String Y 8 时间格式:yyyyMMdd
product_id 产品号 String Y 32 产品号
huifu_id 汇付ID String Y 18  
upper_huifu_id 渠道商汇付Id String N 18  
app_id 开发者的应用ID String N 32 支付宝分配给开发者的应用ID
name 进件的二级商户名称 String Y 128  
alias_name 商户别名 String N 128  
merchant_type 商家类型 String N 10 商家类型： 0：个人商户 ：cert_type填写100（个人身份证）；cert_no填写个人身份证号码； 1:政府机构 ：cert_type填写219（党政机关批准设立文件/行政执法主体资格证）；cert_no填写党政机关批准 设立文件； /行政执法主体资格证编号 2:国营企业 ；cert_type填写201（营业执照）；cert_no填写营业执照号； 3:私营企业 ；cert_type填写201（营业执照）；cert_no填写营业执照号； 4:外资企业 ；cert_type填写201（营业执照）；cert_no填写营业执照号； 5:个体工商户 ：cert_type填写201（营业执照）；cert_no填写营业执照编号； 7:事业单位 ：cert_type填写218（事业单位法人证书）；cert_no填写事业单位法人证书编号； 8:民办非企业组织 ：cert_type填写204（民办非企业登记证书）；cert_no填写民办非企业登记证书编号； 9:社会团体 ：cert_type填写206（社会团体法人登记证书）；cert_no填写社会团体法人登记证书编号；
mcc 商户类别码mcc String Y 10 参见附件描述中的“类目code” 218：https://gw.alipayobjects.com/os/basement_prod/82cb70f7-abbd-417a-91ba-73c1849 49f07ea.xlsx如果要求资质一栏不为空，表明是特殊行业，会有人工审核。注：文档更新可能有滞后性，以实际为准
cert_type 商户证件类型 String Y 10
取值范围：201：营业执照；204：民办非企业登记证书；206：社会团体法人登记证书；218：事业单位法人证书；219：党

政机关批准设立文件/行政执法主体资格证；100：个人商户身份证
cert_no 商户证件编号 String Y 32 商户证件编号（企业或者个体工商户提供营业执照，事业单位提供事证号），个人证件号码
cert_name 证件名称 String C 64 目前只有个体工商户商户类型要求填入本字段，填写值为个体工商户营业执照上的名称
legal_name 法人名称 String C 64 仅个人商户非必填，其他必填
legal_cert_no 法人身份证号 String C 18 仅个人商户非必填，其他必填
legal_cert_type 身份证类型 String N 8 默认可不填，认为legal_cert_no是大陆身份证。类型包括：100 大陆身份证；105 港澳居民往来内地通行证；106 台湾同 胞往来大陆通行证；108 外国人居留证
service_phone 客服电话 String Y 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 64  
contact_tag 商户联系人业务标识 String Y 20 商户联系人业务标识枚举，表示商户联系人的职责。异议处理接口人:02;商户关键联系人:06;数据反馈接口人:11;服务联动 接口人:08； 多个英文逗号分隔，如果：02,06
contact_type 联系人类型 String Y 20 联系人类型，取值范围：LEGAL_PERSON：法人；CONTROLLER：实际控制人；AGENT：代理人；OTHER：其他
contact_mobile_no 联系人手机号 String Y 11  
contact_phone 联系人电话 String N 20  
contact_email 联系人电子邮箱 String N 30  
contact_id_card_no 身份证号 String N 32  
zft_card_info_list 商户结算卡信息 List C   本业务当前只允许传入一张结算卡。与支付宝账号字段二选一必填
alipay_logon_id 商户支付宝账号 String N 64 商户支付宝账号，用作结算账号。与银行卡对象字段二选一必填。本字段要求与商户名称name同名,实名认认证支付宝账户
industry_qualification_type 商户行业资质类型 String N 20 当商户是特殊行业时必填，具体选值参见https://mif-pub.alipayobjects.com/QualificationType.xlsx
service 商户使用服务 String Y 20 可选值有：1：当面付、2：app支付、3：wap支付:4：电脑支付 英文逗号分隔，如果：:1,2,3
sign_time_with_isv 二级商户与服务商的签约时间 String Y 20 格式:yyyy-MM-dd
zft_site_info_list 商户站点信息 List N   如果不传入则合同信息联系人信息和子账户列表信息均不会返回
zft_invoice_info_list 开票资料信息 List N   当前仅支持配置一个开票信息
binding_alipay_logon_id 二级商户支付宝账户 String C 64 用于协议确认。目前商业场景（除医疗、中小学教育等）下必填。本字段要求与商户名称name同名，是实名认证支付宝账户
default_settle_type 默认结算类型 String Y 16 可选值有bankCard/alipayAccount。bankCard表示结算到银行卡；alipayAccount表示结算到支付宝账号
async_return_url 审核结果异步通知地址 String N 128 为空不返回
file_list 文件列表 List Y   附件资料列表fileList

zft_card_info_list(商户结算卡信息)

参数 中文名 类型 必填 最大长度 说明
card_type 账号使用类型 String Y 1 账号使用类型 对公-0 对私-1
card_flag 卡类型 String Y 1 卡类型 借记卡-D 信用卡-C
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 参见附录 银行编码
bank_name 银行名称 String Y 32 参见附录 银行支行编码
branch_code 支行联行号 String Y 12  
branch_name 支行名称 String Y 64  

zft_site_info_list(商户站点信息)

参数 中文名 类型 必填 最大长度 说明
site_type 站点类型 String Y 2 网站：01 APP : 02 服务窗:03 公众号:04 其他:05 支付宝小程序:06
site_url 站点地址 String N 256  
site_name 站点名称 String N 512  
account 测试账号 String N 128  
password 测试密码 String N 128  

zft_invoice_info_list(开票资料信息)

参数 中文名 类型 必填 最大长度 说明
auto_invoice_flag 是否自动开票 String Y 1 Y:是 N:否
accept_electronic_flag 是否接受电子发票 String Y 1 Y:是 N:否
tax_payer_qualification 纳税人资格种类 String Y 2 纳税人资格种类:01一般纳税人，02小规模纳税人。一般纳税人开的是专票
title 发票抬头 String Y 64  
tax_no 纳税人识别号 String Y 64  
tax_payer_valid 纳税人资格开始时间 String Y 8 格式:yyyyMMdd
address 开票地址 String Y 64  
telephone 开票电话 String Y 10 57162288888
bank_account 银行账号 String Y 32  
mail_name 收件人名称 String Y 64  
prov_id 经营省 String Y 6  
area_id 经营市 String Y 8  
district_id 经营区 String Y 12  
detail_addr 经营详细地址 String Y 256  
mail_telephone 寄送电话 String Y 64  
bank_name 开户行名称 String Y 64  
  • file_list(文件列表)
参数 中文名 类型 必填 最大长度 说明
file_type 文件类型 String Y 8
文件类型
F07-营业执照（营业执照图片url，本业务接口中，如果是特殊行业必填。） F02-法人身份证正面（如果是特殊行业必填 ） F03-法人身份证反面（如果是特殊行业必填 ） F47-企业特殊资质图片(当商户是特殊行业时必填 ) F50-店铺门头照图片（当面付服务则必填 ） F48-营业执照授权函图片（当商户名与结算卡户名不一致时必填 ） F40-个人信息身份证人像面（当商户类型是个人商户必填） F41-个人信息身份证国徽面（当商户类型是个人商户必填） (最小5KB，图片格式必须为：png、bmp、gif、jpg、jpeg )
file_id 文件jfileID String Y 128 文件jfileID
file_name 文件名称 String Y 30 格式为：名称.格式

响应参数

  • 响应参数(data)
参数 中文名 类型 必填 最大长度 说明
sub_resp_code 返回码 String Y 8 业务返回码
sub_resp_desc 返回描述 String Y 512 业务返回描述
apply_no 申请单 String N 128 汇付申请单号
  • 异步返回参数
参数 中文名 类型 必填 最大长度 说明
sub_resp_code 返回码 String Y 8 业务返回码
sub_resp_desc 返回描述 String Y 512 业务返回描述
apply_no 申请单 String N 128 汇付申请单号
smid 二级商户id String N 16  
card_alias_no 银行卡编号 String N 32  
audit_status 审核状态 String Y 1 P:审核中 Y：审核通过 N：审核拒绝 F：失败
audit_desc 审核状态描述 String N 128  

请求示例

{
  "data": "{\"req_seq_id\":\"rQ202103233340540085050\",\"req_date\":\"20210323\",\"upper_huifu_id\":\"6666000103518389\",\"product_id\":\"ZDTEST\",\"huifu_id\":\"6666000103518390\",\"app_id\":\"2021002122659346\",\"name\":\"雷均\",\"alias_name\":\"哈市盈超市\",\"merchant_type\":\"0\",\"mcc\":\"5331\",\"cert_type\":\"100\",\"cert_no\":\"120101199003071358\",\"cert_name\":\"I_cert_name\",\"legal_name\":\"雷均\",\"legal_cert_no\":\"120101199003071358\",\"legal_cert_type\":\"100\",\"service_phone\":\"10086\",\"prov_id\":\"310000\",\"area_id\":\"310100\",\"district_id\":\"310104\",\"detail_addr\":\"上海市徐汇区\",\"contact_name\":\"张三\",\"contact_tag\":\"02\",\"contact_type\":\"LEGAL_PERSON\",\"contact_mobile_no\":\"13576266246\",\"contact_phone\":\"13576266246\",\"contact_email\":\"a066545074@qq.com\",\"contact_id_card_no\":\"120101199003071358\",\"alipay_logon_id\":\"13576266246\",\"industry_qualification_type\":\"\",\"service\":\"2\",\"sign_time_with_isv\":\"2021-01-27\",\"binding_alipay_logon_id\":\"13576266246\",\"default_settle_type\":\"alipayAccount\",\"async_return_url\":\"http://192.168.85.157:30031/sspm/testVirgo\",\"zft_card_info_list\":[{\"card_type\":\"1\",\"card_flag\":\"D\",\"card_name\":\"雷均\",\"card_no\":\"6214832144053019\",\"prov_id\":\"310000\",\"area_id\":\"310100\",\"bank_code\":\"03080000\",\"bank_name\":\"招商银行\",\"branch_code\":\"308290003378\",\"branch_name\":\"招商银行股份有限公司上海淮中支行\"}],\"zft_site_info_list\":[{\"site_type\":\"02\",\"site_url\":\"站点地址\",\"site_name\":\"站点名称\",\"account\":\"测试账号\",\"password\":\"测试密码\"}],\"zft_invoice_info_list\":[{\"auto_invoice_flag\":\"N\",\"accept_electronic_flag\":\"N\",\"tax_payer_qualification\":\"01\",\"title\":\"发票抬头\",\"tax_no\":\"纳税人识别号\",\"tax_payer_valid\":\"20210127\",\"address\":\"开票地址\",\"telephone\":\"10087\",\"bank_account\":\"6214832144053019\",\"mail_name\":\"雷均\",\"prov_id\":\"310000\",\"area_id\":\"310100\",\"district_id\":\"310104\",\"detail_addr\":\"经营详细地址\",\"mail_telephone\":\"13576266246\",\"bank_name\":\"招商银行\"}],\"file_list\":[{\"file_type\":\"F41\",\"file_id\":\"c679752a-9abc-326d-bb02-8cf770f56d12\",\"file_name\":\"身份证国徽面\"},{\"file_type\":\"F40\",\"file_id\":\"c679752a-9abc-326d-bb02-8cf770f56d12\",\"file_name\":\"身份证人像面\"}]}",
  "sys_id": "ssproxy_dev",
  "sign": "FIKPd9UyBwuGT8ycfjsRBHDy+QjDxmsmk0WE8TsSPSPmnBLiYoOC8dBWWgwCuag4Am803CHYWZiB5k1etAKqm2R3Fo0v4d3QDDCl9d8zyNQKBEGR53aX7KqH0rAu5yzCW+sVRHYSBwPBvZ+lh127lorMnfb3kWfiVcanwVfdP8o=",
  "sign_type": "RSA2"
}

响应示例

{
  "data":"{\"sub_resp_code\":\"99999999\",\"sub_resp_desc\":\"商户在该渠道下已入驻完成，请勿重复提交\"}",
  "resp_code":"10000",
  "resp_desc":"成功调用",
  "sign":"UczIZk52oVeZlyzGI2ICsZrmwDHbXlJnPxf5PKdEIwnhM311lkmCnzomuC15fyieGl8Uz3O1bi35nBo7AWA4SVotXQ7eydZMD2bkRbxNV7InQ+JQ7ML+5cXRtg5SPzRgCyk3z24bLIPWyOobMztp4+oER9LFp4/avSAh94U7Au8="
}

接口调用示例

Demo参考