接口说明

调用方：商户接入系统

接收方：银账通系统

功能：查询商户列表

请求地址及接口名

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

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

接口名(method)：merchant.mchlist

公共请求参数

名称类型必须描述示例值
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-付款账户
page_numnumber否页数(默认1)
page_sizenumber否每页数量(默认10)

范例：

  1. {
  2.   "sso_node_id": "00061967",
  3.   "merchant_id": 1000000001116,
  4.   "account_sub_type": "0",
  5.   "page_num": 1,
  6.   "page_size": 10
  7. }

请求示例

  1. "biz_content": "{
  2.   "sso_node_id": "00061967",
  3.   "merchant_id": 1000000001116,
  4.   "account_sub_type": "0",
  5.   "page_num": 1,
  6.   "page_size": 10
  7. }",
  8.     "method": "merchant.mchlist",
  9.     "format": "json",
  10.     "sign": "bP6dfs2LgvpxhyeTS+VwfSp+26Pgi6VPLagYIGx5ENL5shQmXWBel56nxkDi22hoopKuqO3FbomxIuFMuMPDWuFzJCHLW2O9yTut+94Rx0f8ICikYVanMAhsaIIeMx0g9AdZzqP2IOou0xD7udmeXmCZqKw/h73+VzXM5aRtSPCeQI7zlKd2wyKmhvjdc9ujXZ5phNeZgdtjLm5tI2Xnq+XIh+6shnRS+4Q1LFo6ubgBsEBHpVo4dsJJSknj4q+9hc38nmpPUNLPIV154Z+WiZsAllXaHunrt5lsnixdrqr3VkkDwpfkH4JzZS0hIZi7CsfhePWgra1GfI/BbYRvwQ==",
  11.     "app_id": "202404221232028501746384896",
  12.     "sign_type": "RSA2",
  13.     "version": "1.0",
  14.     "timestamp": "2024-04-2815:09:29"
  15. }

公共响应参数

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

业务响应参数

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

data 业务数据 (JSONObject)

名称类型必须描述示例值
totallong否总记录数3
pagesinteger否总页数1
page_numinteger否页码1
page_sizeinteger否每页数量10
sizeinteger否当前页数量8
start_rowlong否起始行10
end_rowlong否结束行19
pre_pageinteger否前一页0
next_pageinteger否下一页0
is_first_pageboolean否是否为第一页true
is_last_pageboolean否是否为最后一页false
has_previous_pageboolean否是否有前一页false
has_next_pageboolean否是否有下一页false
navigate_pagesinteger否导航页码数1
navigatepage_numsint[]否所有导航页号【[1,2]
navigate_firse_pageinteger否导航条第一页0
navigate_last_pageinteger否导航条最后一页0
listJSONArray否商户列表　

list 商户列表 (JSONArray)

名称类型必须描述示例值
idLong是商户号1000000001066
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

响应示例

  1. {
  2.     "merchant_mchlist_response": {
  3.         "request_id": "openapi_68bee38c8c244e78a6aabbf6e263346f",
  4.         "code": 10000,
  5.         "data": {
  6.             "total": 1,
  7.             "pages": 1,
  8.             "page_num": 1,
  9.             "page_size": 10,
  10.             "size": 1,
  11.             "start_row": 1,
  12.             "end_row": 10,
  13.             "pre_page": 0,
  14.             "next_page": 0,
  15.             "is_first_page": true,
  16.             "is_last_page": false,
  17.             "has_previous_page": false,
  18.             "has_next_page": true,
  19.             "navigate_pages": 0,
  20.             "navigatepage_nums": [],
  21.             "navigate_firse_page": 0,
  22.             "navigate_last_page": 0,
  23.             "list": [
  24.                 {
  25.                     "id": 1000000001066,
  26.                     "name": "叶良辰百货店",
  27.                     "type": "02",
  28.                     "status": "1",
  29.                     "alias": "叶良辰百货店",
  30.                     "node_id": "1106",
  31.                     "node_name": "657060客户名称111",
  32.                     "cloud_merchant_id": "4458000000136117",
  33.                     "register_status": "5",
  34.                     "channel_status": "2",
  35.                     "channel": "02",
  36.                     "store_count": 0,
  37.                     "created_at": "2025-05-15 12:53:43",
  38.                     "is_platform": "0",
  39.                     "withdrawal_method": 0,
  40.                     "account_sub_type": "0"
  41.                 }
  42.         },
  43.         "success": true
  44.     },
  45.     "sign": "N2XlAGX+GPXmN2rsPHOqexHWDXMt/GlNCKPNJCF1vEj9rEjZrc7fohbpayqE0hwiE7XU6TbVLPDnMcfO+LN/xHc0nUlAYT5oWvlXaS4ku9eZ9qmBylaJ+jWn8lDcGvPlmivRyRU5Qo7M28Nd92XRYPwpTXNOu+W+OCWiPfDgPPjjRnXaSIEVipqP8zo8a71aoeVt7MBIwID+YQEaRK2+Fs6+5reOJR86S2X4UeQo1L47KQ9ULOS0JpTkkMMn7ucjrzHOucbI8JsIg3TNGOZaooy1TJa8oX5TpII+y18DjkImy+YFBvqY/OFZvV2iqCFKF2mKIbpJT39x1eyJFxMJYQ=="
  46. }