概要描述:

该接口用于查询商户信息。

请求URL:

请求参数(O-非必传 ,C-条件必传 ,M-必传)：

参数 参数名称 类型 参数说明 样例 可空
agent_no 海科服务商编号 String 由海科SaaS平台分配，表示当前商户属于该服务商名下 M
store_id 海科门店编号 String 由海科SaaS平台分配的门店编号，门店编号是商户编号的二级编号 M

返回参数说明:

参数 参数名称 类型 参数说明 样例 可空
merch_type 商户类型 String ENTERPRISE：企业；
INSTITUTIONS_CLONED：事业单位；
INDIVIDUAL：个体工商户；
OTHERS：其他组织；
MICRO：小微商户；		 M
merch_name 商户名称 String 企业、个体工商户，请填写营业执照注册名称，最大50个汉字；
注意：个体工商户，若营业执照上商户名称为空或为“无”，请填写”个体户+经营者姓名”，如“个体户张三”；
小微商户，请填写商户+经营者姓名，如“商户_张三”；
事业单位或其他组织，请填写登记证书上的商户名称，如xx公益团体		 M
merch_short_name 商户简称 String 门店名称或店铺名称，展示在收银台页 M
bus_scope_code 经营范围 String Saas经营范围-微信-支付宝-银联 M
merchant_data 商户主体信息 Json 参考下表（商户信息：merchant_data_） M
merchant_corporation_data 商户法人信息 Json 参考下表（商户法人信息：merchant_corporation_data） M
merchant_contact_data 商户联系人信息 Json 参考下表（商户联系人信息：merchant_contact_data） M
bankcard_data 结算卡信息 Json 参考下表（结算卡信息：bankcard_data） M
product_data 支付产品信息 Json 开通微信、支付宝、银联云闪付、银联刷卡 M
settle_data 结算产品信息 Json 开通D1、T1、D0、Dn、Ts、手动提现等 M

商户信息merchant_data_ ：（适用于企业、个体、事业单位、其他组织）

参数 参数名称 类型 参数说明 样例 可空
merch_name 商户名称 String M
merch_short_name 商户简称 String M
bus_scope_code 经营范围 String Saas经营范围 M
cert_type 证件类型 String 证书类型
枚举值：
CERTIFICATE_TYPE_2388：事业单位法人证书
CERTIFICATE_TYPE_2389：统一社会信用代码证书
CERTIFICATE_TYPE_2390：有偿服务许可证（军队医院适用)
CERTIFICATE_TYPE_2391：医疗机构执业许可证（军队医院适用)
CERTIFICATE_TYPE_2392：企业营业执照（挂靠企业的党组织适用)
CERTIFICATE_TYPE_2393：组织机构代码证（政府机关适用)
CERTIFICATE_TYPE_2394：社会团体法人登记证书
CERTIFICATE_TYPE_2395：民办非企业单位登记证书
CERTIFICATE_TYPE_2396：基金会法人登记证书
CERTIFICATE_TYPE_2397：慈善组织公开募捐资格证书
CERTIFICATE_TYPE_2398：农民专业合作社法人营业执照
CERTIFICATE_TYPE_2399：宗教活动场所登记证
CERTIFICATE_TYPE_2400：其他证书/批文/证明		 M
bus_license_no 证件编号 String M
licence_valid_date 证件有效日期 String M
province_code 省份编码 String M
city_code 城市编码 String M
area_code 区县编码 String M
bus_address 营业执照经营地址 String M
address 实际经营地址 String M
customer_phone 客服电话 String M

商户法人信息 merchant_corporation_data

参数 参数名称 类型 参数说明 样例 可空
legal_name 法人姓名 String 请填写法人证件上的姓名，2~30个中文字符、英文字符、符号 M
legal_cert_type 法人证件类型 String IDENTIFICATION_TYPE_IDCARD：身份证（限中国大陆居民)
IDENTIFICATION_TYPE_OVERSEA_PASSPORT：护照（限境外人士)
IDENTIFICATION_TYPE_HONGKONG_PASSPORT ：中国香港居民-来往内地通行证
IDENTIFICATION_TYPE_MACAO_PASSPORT：中国澳门居民-来往内地通行证
IDENTIFICATION_TYPE_TAIWAN_PASSPORT：中国台湾居民-来往大陆通行证		 M
legal_cert_no 法人证件号 String 请填写法人证件上的证件号码 M
identification_valid_date 证件有效日期 String 1、请填写法人证件的有效时间，注意参照示例中的格式；
2、结束时间需大于开始时间；
3、证件有效期需大于60天，即结束时间距当前时间需超过60天。示例值：["1970-01-01","forever"]		 M

商户联系人信息merchant_contact_data

参数 参数名称 类型 参数说明 样例 可空
contact_name 联系人姓名 String M
contact_phone 联系人手机号 String M
contact_email 联系人邮箱 String O

结算卡信息bankcard_data

参数 参数名称 类型 参数说明 样例 可空
settlement_type 结算类型 String 00：标准结算；
01：非法人结算；		 O
acc_type 结算账户类型 String 企业：对公账户/单位结算卡
个体户：对公账户/借记卡
10A：对公账户；
11A：单位结算卡；
10B：对私借记卡；		 M
acc_name 结算账户名称 String M
acc_no 结算账户号 String M
bank_name 开户行银行名称 String acc_type=10A或11A时必填，参考附件 C
bank_province_code 开户行省 String 参考附件：省编码 C
bank_city_code 开户行市 String 参考附件：市编码 C
bank_code 开户行联行号 String acc_type=10A或11A时必填，参考附件 C
idcard_no 持卡人身份证号 String acc_type=10B（对私借记卡）时必传 C
contact_phone 预留手机号 String acc_type=10B（对私借记卡）时必传 C

支付产品开通信息 product_data

参数 参数名称 类型 参数说明 样例 可空
product_type 支付产品类型 String QR_WECHAT：微信；
QR_ALIPAY：支付宝；
QR_UNIONPAY：云闪付；
BANKCARD：银行卡业务；		 M
rate 费率值 String 1.微信、支付宝示例：0.0038;
2.云闪付示例：”defineAmount”:”1000”,
“underDebitRate”: “0.0020”,
“underCreditRate”:”0.0020”,
“aboveDebitRate”: “0.0020”,
“aboveCreditRate”: “0.0020”
云闪付费率表达式解释：defineAmount为阶梯费率临界点金额，为0则视为无阶梯。underDebitRate为小于阶梯金额下的借记卡费率；
underCreditRate为小于阶梯金额下的贷记卡费率；
aboveDebitRate为大于阶梯金额下的借记卡费率； aboveCreditRate为大于阶梯金额下的贷记卡费.
示例：[{“channel_type”:”UP_WX”,”fee_exp”:”0.0038”},
{“channel_type”:”UP_ALIPAY”,”fee_exp”:”0.0038”},
{“channel_type”:”UP_CUP”,”fee_exp”:[{“defineAmount”:”1000”,”underDebitRate”:”0.0020”,”underCreditRate”:”0.0020”,”aboveDebitRate”:”0.0020”,”aboveCreditRate”:”0.0020”}]}]		 M

结算产品开通信息settlement_data

参数 参数名称 类型 参数说明 样例 可空
settlement_type 结算产品类型 String D1_AUTO；
T1_AUTO；
D0_AUTO；
Ts_AUTO；
D1_MANUAL；
D0_MANUAL；		 M
settlement_rate_type 计费策略 String 结算产品类型为D0_AUTO，Ts_AUTO，D0_MANUAL时必填；
SINGLE_PERCENT:单笔百分比；
SINGLE_FIXED:单笔固定值；
FIXED_MIX_PERCENT:单笔固定值 + 单笔百分比；
PERCENT_MIX_CAP:单笔百分比 + 封顶值；；		 C
percentRate 百分比费率值 String 计费策略为 SINGLE_PERCENT、FIXED_MIX_PERCENT、PERCENT_MIX_CAP 时，必填。
该字段单位：%；如 0.5%，上传 0.5 即可。		 C
fixedRate 固定费率值 String 计费策略为 SINGLE_FIXED、FIXED_MIX_PERCENT、PERCENT_MIX_CAP 时，必填。
该字段单位：元/笔；如 5 元/笔，上传 5 即可。		 C
文档更新时间: 2021-03-17 15:00   作者：王金晶