接口说明
调用方:商户接入系统
接收方:银账通系统
功能:商户明细查询
请求地址及接口名
生产环境: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=="
}