接口说明

调用方：商户接入系统

接收方：银账通系统

功能：商户明细查询

请求地址及接口名

生产环境：https://fzxt-yzt-openapi.wangcaio2o.com

测试环境：https://fzxt-yzt-openapi.imageco.cn

接口名(method)：merchant.mchinfo

公共请求参数

名称类型必须描述示例值
app_idstring(32)是接入方appId20210911888888888888888888
methodstring(32)是接口名bkfunds.split.apply
formatstring(16)是报文格式，仅支持JSONjson
charsetstring(16)是字符编码UTF-8
sign_typestring(8)是签名算法类型，仅支持RSA2RSA2
timestampstring(16)是时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8。服务端允许客户端请求最大时间误差为10分钟2021-09-11 12:00:00
versionstring(8)是版本号1.0
app_auth_tokenstring(128)否token01c9a4191bfd4609d26
signstring(256)是请求参数的签名串XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
biz_contentstring是业务请求参数，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档{“file”:””,”type”:”1”}

业务请求参数

名称类型必须描述示例值
sso_node_idstring是机构id
merchant_idLong否翼码商户id
account_sub_typestring否账户类型 0-收款账户 1-付款账户

范例：

  1. {
  2.   "sso_node_id": "00061967",
  3.   "merchant_id": 1000000001116,
  4.   "account_sub_type": "0"
  5. }

请求示例

  1. {
  2.   "sso_node_id": "1106",
  3.   "merchant_id": 1000000001066,
  4.   "account_sub_type": "1",
  5. }",
  6.     "method": "merchant.mchinfo",
  7.     "format": "json",
  8.     "sign": "BCl03jc6RBgKyBuc+Tvh0KG1Jeq8ueYZqY+OCOcO4KnldEpI5Snc/rnGO+p2GUCEbczuU8VQBNzteXOU4HnoFdy4Me5XrzO/UJeIDJRaW+LeLKOM7JSZ8Z1VSscF4Jr/L4+IN9lv3stv+qhoDU4DKmOx/PrqfQ2lO6NaStda33Cu4NTda83VlsE/hD2mOSvDO1u75Hg2tHQpe8MSzwOj7lzTU2xijlm1gQt+OA/b+91sA1d1GvEfTG4qqQlVFEkr4FqS1b/qkC+Ex1M1XtaChGgL/BeINVvjdh4lTn5K/ZLbZE5FuXkRPE6zZqcq7kGbN2B3iBiz1v7UsTLkP0ZaBA==",
  9.     "app_id": "20211012897445821048422400",
  10.     "sign_type": "RSA2",
  11.     "version": "1.0",
  12.     "timestamp": "2024-04-2815:09:29"
  13. }

公共响应参数

名称类型必须描述示例值
request_idstring是每次请求唯一id4e770f101c9a4191bfd4609d26c6e0bd
codeinteger是返回码10000
signstring是响应参数的签名串XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

业务响应参数

名称类型必须描述示例值
dataJSONObject否业务数据
successboolean否是否成功true

data 业务数据 (JSONObject)

名称类型必须描述示例值
namestring否商户名称叶良辰百货店
typestring否商户类型: 01=自然人, 02=个体工商户, 03=企业商户02
statusstring否商户状态, 0=关闭,1=正常1
aliasString否商户简称叶良辰百货店
node_idString是平台号1106
node_nameString否平台名称657060客户名称111
cloud_merchant_idString否当前生效的渠道商户号4458000000136117
register_statusString否进件状态：1=待处理(内部注册)，2=审核中(网商预入驻)，3=待激活(网商待激活)，4=待签约(网商待待签约)，5=进件成功，6=进件失败。5
channel_statusString否商户在第三方渠道的进件状态: 0=未进件, 1=待查询(待审核), 2=进件完成, 3-进件失败(审核失败)2
channelString否渠道：01=网商，02=平安02
store_countinteger否绑定门店数1
created_atDate否创建时间2025-05-15 12:53:43
is_platformString否商户身份：0=商户，1=平台0
withdrawal_methodinteger否提现方式 0-自动结算 1-手动提现0
account_sub_typeinteger否商户类型 0-收款账户 1-付款账户0
accountString否登录账号17211112232
merchant_idString否翼码商户号1000000001066
frozen_balancelong否冻结余额0
available_balancelong否本地可用余额0
total_balancelong否本地总余额0
remote_frozen_balancelong否银行端冻结余额0
remote_available_balancelong否银行端可用余额0
remote_withdraw_balancelong否银行端可提现余额0
open_pay_statusinteger否开通余额支付状态：-1=实名开户失败(6248失败)，0=实名开户成功(6248成功), 2=平安申请小额鉴权失败(6240失败), 1=平安申请小额鉴权成功(6240,6248都成功)0
send_sms_taginteger否新增商户时是否已发送短信通知：0=不发，1=发送0
bankcardDetailListJSONObject否银行卡信息
storeResultJSONObject否门店信息

bankcardDetailList 业务数据 (JSONObject)

名称类型必须描述示例值

storeResult 业务数据 (JSONObject)

名称类型必须描述示例值

响应示例

  1. {
  2.     "merchant_mch_info_response": {
  3.         "request_id": "openapi_aec0f4f8091c44baa7f692bff7528730",
  4.         "code": 10000,
  5.         "data": {
  6.             "type": "02",
  7.             "name": "哈哈哈零食店",
  8.             "alias": "哈哈哈零食店",
  9.             "detail": {
  10.                 "buss_auth_type": "11",
  11.                 "buss_auth_no": "92530136MPBR5PTX14",
  12.                 "principal_person": "叶良辰",
  13.                 "principal_cert_no": "421126999922226543",
  14.                 "principal_mobile": "11111111111",
  15.                 "principal_cert_type": "1",
  16.                 "country_code": "",
  17.                 "occupation_code": "",
  18.                 "license_begin_date": "",
  19.                 "license_end_date": "",
  20.                 "license_validity_type": "",
  21.                 "province_code": "",
  22.                 "city_code": "",
  23.                 "area_code": "",
  24.                 "address": "",
  25.                 "first_industry_code": "",
  26.                 "second_industry_code": "",
  27.                 "third_industry_code": "",
  28.                 "third_industry_name": "",
  29.                 "currency_code": "",
  30.                 "register_capital": "",
  31.                 "business_province_code": "",
  32.                 "business_city_code": "",
  33.                 "business_area_code": "",
  34.                 "business_address": "",
  35.                 "contact_code": "",
  36.                 "cert_photo_a": "",
  37.                 "cert_photo_b": "",
  38.                 "license_photo": "",
  39.                 "business_scope": "",
  40.                 "province_name": "",
  41.                 "city_name": "",
  42.                 "area_name": "",
  43.                 "business_province_name": "",
  44.                 "business_city_name": "",
  45.                 "business_area_name": "",
  46.                 "gender": "U",
  47.                 "identity_begin_date": "",
  48.                 "identity_end_date": "",
  49.                 "identity_validity_type": "",
  50.                 "withdrawal_method": 0,
  51.                 "withdrawal_auto": "0"
  52.             },
  53.             "bankcardDetailList": [
  54.                 {
  55.                     "id": 887,
  56.                     "bank_card_no": "15000308773997",
  57.                     "bank_cert_name": "银企直联智能清分测试数据",
  58.                     "account_type": "03",
  59.                     "bank_id": "307584007998",
  60.                     "bank_name": "平安银行",
  61.                     "settlement_account_type": "01",
  62.                     "card_type": "0",
  63.                     "account_sub_type": "0",
  64.                     "enabled": "0"
  65.                 }
  66.             ],
  67.             "storeResult": [
  68.                 {
  69.                     "store_id": 1983618,
  70.                     "merchant_id": 1000000001130,
  71.                     "custom_no": "amy99d",
  72.                     "store_name": "阿吉豆银企直连门店1",
  73.                     "mt_store_id": "",
  74.                     "ele_store_id": "",
  75.                     "type": "1",
  76.                     "channel": "02",
  77.                     "node_id": 1113,
  78.                     "created_at": "2025-06-30 15:55:31",
  79.                     "external_custom_no": "amy99d",
  80.                     "external_store_id": "01983618",
  81.                     "external_store_name": "阿吉豆银企直连门店1"
  82.                 }
  83.             ],
  84.             "account": "15623452345",
  85.             "merchant_id": "1000000001130",
  86.             "cloud_merchant_id": "4609000000001138",
  87.             "created_at": "2025-05-30 14:00:11",
  88.             "node_id": "1113",
  89.             "node_name": "18823657777",
  90.             "merchant_type_id": 107,
  91.             "is_platform": "0",
  92.             "frozen_balance": 0,
  93.             "available_balance": 0,
  94.             "total_balance": 0,
  95.             "remote_frozen_balance": 0,
  96.             "remote_available_balance": 0,
  97.             "remote_withdraw_balance": 0,
  98.             "register_status": "6",
  99.             "last_fail_reason": "申请小额鉴权失败，请重新提交。失败原因：交易要素不全或字段长度非法,请核对请求要素",
  100.             "open_pay_status": "2",
  101.             "send_sms_tag": "0",
  102.             "withdrawal_method": 0,
  103.             "account_sub_type": "0"
  104.         },
  105.         "success": true
  106.     },
  107.     "sign": "Zo9fgteXVcpGqdBu+luRXx1jbxYsOYohDeh/Z3haEqvz+pcURJcYW6lnC3ZpW6r2Z0GGpJta0aanEpgUQYL141Jz2EzRXIvhOq5B5RuW5w1ndz1fN6eoXOQM3Wwo8wQ/wfQdZmV6QPFq/YM2l3zOOo+9flN21L9eFEA5MQKcohQA43VItTfGFLRVz4bxMFmXd/Ml/G86rniapWjAgnPec/dtq4dxt16wXybBP164T3hpjkGBqJo1T+e8iqtWcw6ufbwq8/ZExM3dtMQ9U6feLbOEBoVBg7DXMlCIYZ3oZn5AX98BqxjUGSkK62YCkHZwT5krnIVGgsHBLsuadey2yQ=="
  108. }