接口说明

调用方：商户接入系统

接收方：银账通系统

功能：查询平台各子账户余额。

请求地址及接口名

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

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

接口名(method)：platform.acct.balence.query

公共请求参数

名称类型必须描述示例值
app_idstring(32)是接入方appId20210911888888888888888888
methodstring(32)是接口名platform.acct.balence.query
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”}

业务请求参数

名称类型必须描述示例值
node_idstring(8)是机构号00025633

请求示例

  1. {
  2.     "charset": "utf-8",
  3.     "biz_content": "{\"node_id\":\"00025633\"}",
  4.     "method": "platform.acct.balence.query",
  5.     "format": "json",
  6.     "sign": "bP6dfs2LgvpxhyeTS+VwfSp+26Pgi6VPLagYIGx5ENL5shQmXWBel56nxkDi22hoopKuqO3FbomxIuFMuMPDWuFzJCHLW2O9yTut+94Rx0f8ICikYVanMAhsaIIeMx0g9AdZzqP2IOou0xD7udmeXmCZqKw/h73+VzXM5aRtSPCeQI7zlKd2wyKmhvjdc9ujXZ5phNeZgdtjLm5tI2Xnq+XIh+6shnRS+4Q1LFo6ubgBsEBHpVo4dsJJSknj4q+9hc38nmpPUNLPIV154Z+WiZsAllXaHunrt5lsnixdrqr3VkkDwpfkH4JzZS0hIZi7CsfhePWgra1GfI/BbYRvwQ==",
  7.     "app_id": "202404221232028501746384896",
  8.     "sign_type": "RSA2",
  9.     "version": "1.0",
  10.     "timestamp": "2024-04-28 15:09:29"
  11. }

公共响应参数

名称类型必须描述示例值
request_idstring是每次请求唯一id4e770f101c9a4191bfd4609d26c6e0bd
codeinteger是返回码10000
msgstring是返回信息success
sub_codestring是请求失败返回的子错误码isv.invalid-app-key
sub_msgstring是请求失败返回的子错误信息无效的app_id参数
signstring是响应参数的签名串XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

业务响应参数

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

data 业务数据列表 (JSONArray)

名称类型必须描述示例值
sub_acct_nostring(32)是账户号4609000000000002
sub_acct_propertystring(32)是账户类型挂账子账号
sub_acct_namestring(64)是账户名称挂账子台账
acct_avail_balinteger是可用金额，单位：分997904073
cash_amtinteger是可提现金额，单位：分997904073

响应示例

  1. {
  2.     "platform_acct_balence_query_response": {
  3.         "request_id": "openapi_deb039aa78a84bd89879d3153454a386",
  4.         "code": 10000,
  5.         "data": [
  6.             {
  7.                 "sub_acct_no": "4609000000000002",
  8.                 "sub_acct_property": "挂账子账号",
  9.                 "sub_acct_name": "挂账子台账",
  10.                 "acct_avail_bal": 997904073,
  11.                 "cash_amt": 997904073
  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": "a04QCJwLCVftpRsoERvOQ2fCjg2D95LasIjbQuPGsfh1cZucOmsBOrFJiV9/ir6H7jOEUByoSmZ8hrCJHBOS9e78NWbldPP1EyGWCB58+mQaP6w75njgZPP5lLAysQyq6YW0PYlX3GEA6xDVRoMsJhf0URRM3xHUJPJahDmG4JZyXeLa1kRdg/9kq1FXORVA4CNU7PnNQmMYlvYLod54a6k3wNcNVmTtyBFPpG2YU/oSyxtVA/iJhwDkiyA576FQ1vNDazqueV+FDASgESif1lK73bgvAFpy/STAXQrva4eo822RucK113oQrNeZYb2iDvU7X17ZkTHv+hQ3POmhaw=="
  66. }