接口说明

调用方：商户接入系统

接收方：银账通系统

功能：商户余额查询

请求地址及接口名

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

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

接口名(method)：platform.mch.BalanceQuery

公共请求参数

名称类型必须描述示例值
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

范例：

  1. {
  2.   "sso_node_id": "00061967"
  3. }

请求示例

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

公共响应参数

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

业务响应参数

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

data 业务数据 (JSONObject)

名称类型必须描述示例值
sub_acct_nostring否商户名称叶良辰百货店
sub_acct_propertystring否商户类型: 01=自然人, 02=个体工商户, 03=企业商户02
sub_acct_namestring否商户状态, 0=关闭,1=正常1
acct_avail_balString否商户简称叶良辰百货店
cash_amtString是平台号1106

响应示例

  1. {
  2.     "platform_mch_BalanceQuery_response": {
  3.         "request_id": "openapi_8a1bbf33c63441c28f1fd1e352cd29d3",
  4.         "code": 10000,
  5.         "data": [
  6.             {
  7.                 "sub_acct_no": "4609000000000002",
  8.                 "sub_acct_property": "挂账子账号",
  9.                 "sub_acct_name": "挂账子台账",
  10.                 "acct_avail_bal": 997548571,
  11.                 "cash_amt": 997548571
  12.             },
  13.             {
  14.                 "sub_acct_no": "4609000000000005",
  15.                 "sub_acct_property": "平台担保子账号",
  16.                 "sub_acct_name": "平台担保子台账",
  17.                 "acct_avail_bal": 97,
  18.                 "cash_amt": 0
  19.             },
  20.             {
  21.                 "sub_acct_no": "4609000000000004",
  22.                 "sub_acct_property": "利息子账号",
  23.                 "sub_acct_name": "利息子台账",
  24.                 "acct_avail_bal": 0,
  25.                 "cash_amt": 0
  26.             },
  27.             {
  28.                 "sub_acct_no": "4609000000000007",
  29.                 "sub_acct_property": "平台在途子账户 ",
  30.                 "sub_acct_name": "平台在途子台账",
  31.                 "acct_avail_bal": 0,
  32.                 "cash_amt": 0
  33.             },
  34.             {
  35.                 "sub_acct_no": "4609000000000013",
  36.                 "sub_acct_property": "营销子账户",
  37.                 "sub_acct_name": "营销子台账",
  38.                 "acct_avail_bal": 0,
  39.                 "cash_amt": 0
  40.             },
  41.             {
  42.                 "sub_acct_no": "4609000000000021",
  43.                 "sub_acct_property": "21",
  44.                 "sub_acct_name": "退款垫款子台账",
  45.                 "acct_avail_bal": 0,
  46.                 "cash_amt": 0
  47.             },
  48.             {
  49.                 "sub_acct_no": "4609000000000075",
  50.                 "sub_acct_property": "75",
  51.                 "sub_acct_name": "司法划扣子台账",
  52.                 "acct_avail_bal": 0,
  53.                 "cash_amt": 0
  54.             },
  55.             {
  56.                 "sub_acct_no": "4609000000000003",
  57.                 "sub_acct_property": "手续费子账号",
  58.                 "sub_acct_name": "手续费子台账",
  59.                 "acct_avail_bal": 3,
  60.                 "cash_amt": 3
  61.             }
  62.         ],
  63.         "success": true
  64.     },
  65.     "sign": "JHGrKNXv46qKE4oIGFMPUH/bmZk05TPqP27Vt4cqFpo9d6lK3+Kn9vpp4hejQIlGaOzwtPmBfbX9eL+aJaE+aGtaJDO926KIoX2rCBFjeJwbsjiPlrFznfEYfGeNhQN0AY/2QfTG6L1dmlycz6ckzjt6iyHhXg+ZZgF0LkaRkmehRdiBY4vhkZXIy27iCXC3enENoQ+Wn9YHAOl0w8fhJNor5i2ikdajhBM2Udf6qfUkiuPwh098taf6YmOMJBnXlmb0WtpdxSe4grERxz3ao8HkDycXVNdJ3qwTEZlaghZn3aPuebkw4HPWQ/4G+d9BH5Jo0BAS2NkN0ssC9mbPnQ=="
  66. }