接口说明
调用方:商户接入系统
接收方:银账通系统
功能:商户明细查询
请求地址及接口名
生产环境:https://fzxt-yzt-openapi.wangcaio2o.com
测试环境:https://fzxt-yzt-openapi.imageco.cn
接口名(method):merchant.mch.info
公共请求参数
| 名称 | 类型 | 必须 | 描述 | 示例值 |
|---|---|---|---|---|
| app_id | string(32) | 是 | 接入方appId | 20210911888888888888888888 |
| method | string(32) | 是 | 接口名 | bkfunds.split.apply |
| format | string(16) | 是 | 报文格式,仅支持JSON | json |
| charset | string(16) | 是 | 字符编码 | UTF-8 |
| sign_type | string(8) | 是 | 签名算法类型,仅支持RSA2 | RSA2 |
| timestamp | string(16) | 是 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8。服务端允许客户端请求最大时间误差为10分钟 | 2021-09-11 12:00:00 |
| version | string(8) | 是 | 版本号 | 1.0 |
| app_auth_token | string(128) | 否 | token | 01c9a4191bfd4609d26 |
| sign | string(256) | 是 | 请求参数的签名串 | XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| biz_content | string | 是 | 业务请求参数,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档 | {“file”:””,”type”:”1”} |
业务请求参数
| 名称 | 类型 | 必须 | 描述 | 示例值 |
|---|---|---|---|---|
| sso_node_id | string | 是 | 机构id | |
| merchant_id | Long | 否 | 翼码商户id | |
| account_sub_type | string | 否 | 账户类型 0-收款账户 1-付款账户 |
范例:
{"sso_node_id": "00061967","merchant_id": 1000000001116,"account_sub_type": "0"}
请求示例
"biz_content": "{"sso_node_id": "00061442","merchant_id": 1000000001066,"account_sub_type": "1"}","method": "merchant.mch.info","format": "json","sign": "BCl03jc6RBgKyBuc+Tvh0KG1Jeq8ueYZqY+OCOcO4KnldEpI5Snc/rnGO+p2GUCEbczuU8VQBNzteXOU4HnoFdy4Me5XrzO/UJeIDJRaW+LeLKOM7JSZ8Z1VSscF4Jr/L4+IN9lv3stv+qhoDU4DKmOx/PrqfQ2lO6NaStda33Cu4NTda83VlsE/hD2mOSvDO1u75Hg2tHQpe8MSzwOj7lzTU2xijlm1gQt+OA/b+91sA1d1GvEfTG4qqQlVFEkr4FqS1b/qkC+Ex1M1XtaChGgL/BeINVvjdh4lTn5K/ZLbZE5FuXkRPE6zZqcq7kGbN2B3iBiz1v7UsTLkP0ZaBA==","app_id": "20211012897445821048422400","sign_type": "RSA2","version": "1.0","timestamp": "2024-04-2815:09:29"}
公共响应参数
| 名称 | 类型 | 必须 | 描述 | 示例值 |
|---|---|---|---|---|
| request_id | string | 是 | 每次请求唯一id | 4e770f101c9a4191bfd4609d26c6e0bd |
| code | integer | 是 | 返回码 | 10000 |
| sign | string | 是 | 响应参数的签名串 | XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
业务响应参数
| 名称 | 类型 | 必须 | 描述 | 示例值 |
|---|---|---|---|---|
| data | JSONObject | 否 | 业务数据 | |
| success | boolean | 否 | 是否成功 | true |
data 业务数据 (JSONObject)
| 名称 | 类型 | 必须 | 描述 | 示例值 |
|---|---|---|---|---|
| name | string | 否 | 商户名称 | 叶良辰百货店 |
| type | string | 否 | 商户类型: 01=自然人, 02=个体工商户, 03=企业商户 | 02 |
| status | string | 否 | 商户状态, 0=关闭,1=正常 | 1 |
| alias | String | 否 | 商户简称 | 叶良辰百货店 |
| node_id | String | 是 | 平台号 | 1106 |
| node_name | String | 否 | 平台名称 | 657060客户名称111 |
| cloud_merchant_id | String | 否 | 当前生效的渠道商户号 | 4458000000136117 |
| register_status | String | 否 | 进件状态:1=待处理(内部注册),2=审核中(网商预入驻),3=待激活(网商待激活),4=待签约(网商待待签约),5=进件成功,6=进件失败。 | 5 |
| channel_status | String | 否 | 商户在第三方渠道的进件状态: 0=未进件, 1=待查询(待审核), 2=进件完成, 3-进件失败(审核失败) | 2 |
| channel | String | 否 | 渠道:01=网商,02=平安 | 02 |
| store_count | integer | 否 | 绑定门店数 | 1 |
| created_at | Date | 否 | 创建时间 | 2025-05-15 12:53:43 |
| is_platform | String | 否 | 商户身份:0=商户,1=平台 | 0 |
| withdrawal_method | integer | 否 | 提现方式 0-自动结算 1-手动提现 | 0 |
| account_sub_type | integer | 否 | 商户类型 0-收款账户 1-付款账户 | 0 |
| account | String | 否 | 登录账号 | 17211112232 |
| merchant_id | String | 否 | 翼码商户号 | 1000000001066 |
| frozen_balance | long | 否 | 冻结余额 | 0 |
| available_balance | long | 否 | 本地可用余额 | 0 |
| total_balance | long | 否 | 本地总余额 | 0 |
| remote_frozen_balance | long | 否 | 银行端冻结余额 | 0 |
| remote_available_balance | long | 否 | 银行端可用余额 | 0 |
| remote_withdraw_balance | long | 否 | 银行端可提现余额 | 0 |
| open_pay_status | integer | 否 | 开通余额支付状态:-1=实名开户失败(6248失败),0=实名开户成功(6248成功), 2=平安申请小额鉴权失败(6240失败), 1=平安申请小额鉴权成功(6240,6248都成功) | 0 |
| send_sms_tag | integer | 否 | 新增商户时是否已发送短信通知:0=不发,1=发送 | 0 |
| bankcardDetailList | JSONObject | 否 | 银行卡信息 | |
| storeResult | JSONObject | 否 | 门店信息 |
bankcardDetailList 业务数据 (JSONObject)
| 名称 | 类型 | 必须 | 描述 | 示例值 |
|---|---|---|---|---|
|id|Integer|否|银行卡ID|887|
|bank_card_no|String|否|银行卡号|15000308773997|
|bank_cert_name|String|否|银行账户户名|银企直联智能清分测试数据|
|account_type|String|否|账户类型::01=对私账户(自然人、个体工商户可选),02=对公账户,03=法人对私|03|
|bank_id|String|否|银行id|307584007998|
|bank_name|long|否|银行名称|平安银行|
|settlement_account_type|String|否|结算类型: 01=银行卡, 02=支付宝|01|
|card_type|String|否|结算卡标识 0-提现卡 1-费用卡 2-其他卡|0|
|account_sub_type|String|否|账户类型 0-收款账户 1-付款账户|0|
|enabled|String|否|0 禁用 1启用|0|
storeResult 业务数据 (JSONObject)
| 名称 | 类型 | 必须 | 描述 | 示例值 |
|---|---|---|---|---|
| store_id | Integer | 否 | 门店ID | 1983618 |
| merchant_id | Long | 否 | 商户id | 1000000001130 |
| custom_no | String | 否 | 自定义门店号 | amy99d |
| store_name | String | 否 | 门店名称 | xxx银企直连门店1 |
| mt_store_id | String | 否 | 美团门店编号 | 0 |
| ele_store_id | String | 否 | 饿了么门店编号 | 0 |
| type | String | 否 | 门店类型:1=直营门店,2=加盟门店 | 1 |
| channel | String | 否 | 渠道:01-网商 02 平安 | 02 |
| node_id | Integer | 否 | 平台id | 1113 |
| created_at | String | 否 | 创建时间 | 2025-06-30 15:55:31 |
| external_custom_no | String | 否 | 支付门店自定义编号 | amy99d |
| external_store_id | String | 否 | 支付门店id | 01983618 |
| external_store_name | String | 否 | 支付门店名称 | xxx银企直连门店1 |
detail 业务数据 (JSONObject)
| 名称 | 类型 | 必须 | 描述 | 示例值 |
|---|---|---|---|---|
| buss_auth_no | String | 否 | 证件号码若商户类型为“个体工商户”、“企业”需要填写证件号码备注:个体工商户:填写营业执照号企业:填写营业执照号或统一社会信用代码 | 92530136MPBR5PTX14 |
| principal_person | String | 否 | 法人姓名1、企业商户填写为法人姓名;2、个体工商户填写经营者本人的姓名;3、自然人填写负责人的姓名;最大支持15个汉字 | 叶良辰 |
| principal_cert_no | String | 否 | 法人证件号码1、企业商户填写为法人的身份证号码;2、个体工商户填写经营者本人的身份证号码;3、自然人填写负责人的身份证号码 | 421126999922226543 |
| principal_mobile | String | 否 | 法人手机号,11位数字,开户发送的短信验证码的手机号需要和负责人手机号一致。自然人和个体户必传,企业非必传 | 11111111111 |
| principal_cert_type | String | 否 | 法人证件类型:1=身份证,3=港澳台居民通行证(即回乡证),4=中国护照,5=台湾居民来往大陆通行证(即台胞证),19=外国护照 | 1 |
| country_code | String | 否 | 国家代码 | |
| occupation_code | String | 否 | 职业代码 | |
| license_begin_date | String | 否 | 商户证件有效开始日期,格式yyyyMMdd | |
| license_end_date | String | 否 | 商户证件有效截止日期,格式yyyyMMdd,长期有效时填99991231 | |
| license_validity_type | String | 否 | 商户证件有效期类型:1=长期有效,0=非长期 | |
| province_code | String | 否 | 省码 | |
| city_code | String | 否 | 市码 | |
| area_code | String | 否 | 区码 | |
| address | String | 否 | 详细地址 | |
| first_industry_code | String | 否 | 一级行业编码 | |
| second_industry_code | String | 否 | 二级行业编码 | |
| third_industry_code | String | 否 | 三级行业编码 | |
| third_industry_name | String | 否 | 三级行业名称 | |
| currency_code | String | 否 | 注册币种 | |
| register_capital | String | 否 | 注册资本 | |
| business_province_code | String | 否 | 经营信息省码 | |
| business_city_code | String | 否 | 经营信息市码 | |
| buss_auth_type | String | 否 | 证件类型若商户类型为“个体工商户”、“企业”需要填写证件类型12:营业执照/统一社会信用代码 41:政府机关证件42:部队证件43:社会团体证件 44:事业单位证件 45:民办非企业组织证件 99:其它企业类型证件备注:个体工商户:选择12企业:选择12 | 11 |
| business_area_code | String | 否 | 经营信息区码 | |
| business_address | String | 否 | 经营信息详细地址 | |
| contact_code | String | 否 | 联系方式类型 | |
| cert_photo_a | String | 否 | 身份证正面(人像面) | |
| cert_photo_b | String | 否 | 身份证反面(国徽面) | |
| license_photo | String | 否 | 商户证件照 | |
| business_scope | String | 否 | 经营范围 | |
| province_name | String | 否 | 省 | |
| city_name | String | 否 | 市 | |
| area_name | String | 否 | 区 | |
| business_province_name | String | 否 | 经营信息省 | |
| business_city_name | String | 否 | 经营信息市 | |
| business_area_name | String | 否 | 经营信息区 | |
| gender | String | 否 | 性别:U=未知,M=男性,F=女性 | U |
| identity_begin_date | String | 否 | 商户证件有效开始日期 | |
| identity_end_date | String | 否 | 商户证件有效截止日期 | |
| identity_validity_type | String | 否 | 商户证件有效期类型:1=长期有效,0=非长期 | |
| withdrawal_method | String | 否 | 提现方式 | 0 |
| withdrawal_auto | String | 否 | 是否开启自动提现 | 0 |
响应示例
{"merchant_mch_info_response": {"request_id": "openapi_aec0f4f8091c44baa7f692bff7528730","code": 10000,"data": {"type": "02","name": "哈哈哈零食店","alias": "哈哈哈零食店","detail": {"buss_auth_type": "11","buss_auth_no": "92530136MPBR5PTX14","principal_person": "叶良辰","principal_cert_no": "421126999922226543","principal_mobile": "11111111111","principal_cert_type": "1","country_code": "","occupation_code": "","license_begin_date": "","license_end_date": "","license_validity_type": "","province_code": "","city_code": "","area_code": "","address": "","first_industry_code": "","second_industry_code": "","third_industry_code": "","third_industry_name": "","currency_code": "","register_capital": "","business_province_code": "","business_city_code": "","business_area_code": "","business_address": "","contact_code": "","cert_photo_a": "","cert_photo_b": "","license_photo": "","business_scope": "","province_name": "","city_name": "","area_name": "","business_province_name": "","business_city_name": "","business_area_name": "","gender": "U","identity_begin_date": "","identity_end_date": "","identity_validity_type": "","withdrawal_method": 0,"withdrawal_auto": "0"},"bankcardDetailList": [{"id": 887,"bank_card_no": "15000308773997","bank_cert_name": "银企直联智能清分测试数据","account_type": "03","bank_id": "307584007998","bank_name": "平安银行","settlement_account_type": "01","card_type": "0","account_sub_type": "0","enabled": "0"}],"storeResult": [{"store_id": 1983618,"merchant_id": 1000000001130,"custom_no": "amy99d","store_name": "阿吉豆银企直连门店1","mt_store_id": "","ele_store_id": "","type": "1","channel": "02","node_id": 1113,"created_at": "2025-06-30 15:55:31","external_custom_no": "amy99d","external_store_id": "01983618","external_store_name": "阿吉豆银企直连门店1"}],"account": "15623452345","merchant_id": "1000000001130","cloud_merchant_id": "4609000000001138","created_at": "2025-05-30 14:00:11","node_id": "1113","node_name": "18823657777","merchant_type_id": 107,"is_platform": "0","frozen_balance": 0,"available_balance": 0,"total_balance": 0,"remote_frozen_balance": 0,"remote_available_balance": 0,"remote_withdraw_balance": 0,"register_status": "6","last_fail_reason": "申请小额鉴权失败,请重新提交。失败原因:交易要素不全或字段长度非法,请核对请求要素","open_pay_status": "2","send_sms_tag": "0","withdrawal_method": 0,"account_sub_type": "0"},"success": true},"sign": "Zo9fgteXVcpGqdBu+luRXx1jbxYsOYohDeh/Z3haEqvz+pcURJcYW6lnC3ZpW6r2Z0GGpJta0aanEpgUQYL141Jz2EzRXIvhOq5B5RuW5w1ndz1fN6eoXOQM3Wwo8wQ/wfQdZmV6QPFq/YM2l3zOOo+9flN21L9eFEA5MQKcohQA43VItTfGFLRVz4bxMFmXd/Ml/G86rniapWjAgnPec/dtq4dxt16wXybBP164T3hpjkGBqJo1T+e8iqtWcw6ufbwq8/ZExM3dtMQ9U6feLbOEBoVBg7DXMlCIYZ3oZn5AX98BqxjUGSkK62YCkHZwT5krnIVGgsHBLsuadey2yQ=="}


