接口说明

调用方：商户接入系统

接收方：银账通系统

功能：查询企业账户余额，仅支持平安银行通道。

请求地址及接口名

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

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

接口名(method)：bedl.ent.acct.balence.query

公共请求参数

名称类型必须描述示例值
app_idstring(32)是接入方appId20210911888888888888888888
methodstring(32)是接口名bedl.ent.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
accountstring(20)是账号15000100714429
query_seqstring否查询请求流水号，可空，但建议传入一个随机值，便于日志排查00026713X20250601151617_00000001
ccy_typestring(1)否钞汇标志：C-钞户，R-汇户，默认为CC
ccy_codestring(1)否货币类型：RMB-人民币，USD-美元，HKD-港币，默认为RMBRMB

请求示例

  1. {
  2.     "charset": "utf-8",
  3.     "biz_content": "{\"node_id\":\"00025633\",\"account\":\"15000100714429\",\"query_seq\":\"00026713X20250601151617_00000001\"}",
  4.     "method": "bedl.ent.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-2815:09:29"
  11. }

公共响应参数

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

业务响应参数

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

data 业务数据 (JSONObject)

名称类型必须描述示例值
accountstring(20)否账号15000100714429
ccy_typestring(1)否钞汇标志：C-钞户，R-汇户C
ccy_codestring(1)否货币类型：RMB-人民币，USD-美元，HKD-港币RMB
account_namestring(60)否账户户名前端数据支持测试北京拓诊有限公司
account_statusstring(10)否账户状态：A-正常，D-不动户，I-久悬户，DGZH02-账户止付
若有多个状态，“|”分割，如：A|DGZH02		A
balancelong否可用余额：不含集团现金管理合约余额，单位：分17822410868175
total_amountlong否账面余额，不含集团现金管理合约余额，单位：分17822410868175
hold_balancelong否冻结金额，单位：分0
stop_balancelong否止付金额，单位：分0
last_balancelong否昨日金额，单位：分17822410888945
acct_balancelong否账户余额，单位：分17822410868175
agree_dep_reserve_balancelong否协定额度，协定存款留存余额，单位：分0
h_rate1string否活期存款计息执行利率，单位：%
精度：decimal(2,6)		0.300000
x_d_rate2string否协定执行利率，协议存款计息执行利率，单位：%
精度：decimal(2,6)		0.000000
begin_effect_datestring否开始生效日期，yyyy-MM-dd HH:mm:ss2025-06-01 00:00:00
expiry_datestring否到期日，yyyy-MM-dd HH:mm:ss2030-06-01 23:59:59
agree_deposit_interestlong否利息金额，协定存款利息，单位：分0
agree_deposit_interest_typestring否利息种类，协定利息
enable_flag_end_timestring否触发标识确定协议的结束时间，协定到期日，yyyy-MM-dd HH:mm:ss2030-06-01 23:59:59

响应示例

  1. {
  2.     "bedl_ent_acct_balence_query_response": {
  3.         "request_id": "openapi_df2f3932cd88441781b167e76039f642",
  4.         "code": 10000,
  5.         "data": {
  6.             "account": "15000100714429",
  7.             "ccy_type": "C",
  8.             "ccy_code": "RMB",
  9.             "account_name": "前端数据支持测试北京拓诊有限公司",
  10.             "account_status": "A",
  11.             "balance": 17822410868175,
  12.             "total_amount": 17822410868175,
  13.             "hold_balance": 0,
  14.             "stop_balance": 0,
  15.             "last_balance": 17822410888945,
  16.             "acct_balance": 17822410868175,
  17.             "agree_dep_reserve_balance": 0,
  18.             "h_rate1": "0.300000",
  19.             "x_d_rate2": "0.000000",
  20.             "begin_effect_date": "2025-06-01 00:00:00",
  21.             "expiry_date": "2030-06-01 23:59:59",
  22.             "agree_deposit_interest": 0,
  23.             "agree_deposit_interest_type": null,
  24.             "enable_flag_end_time": "2030-06-01 23:59:59",
  25.         },
  26.         "success": true
  27.     },
  28.     "sign": "cSkhGHI413Ob77ixs4HQr4MKah+tLGJVnPuOm7lxj5C+ZK768w9ykhRZs0OE7zc9DVEJjDCHSZxD7hH/bSefnarx8scKnevS9LvQ4ksGrtWkbljnP0wbgtxWPoq8pYO2F6PNhQTXuYarQC++VJFT3l/vsC7tbNxvtP74orgwi68C8jxIhrBlF5H2FBsproWrlCTNo0E75kY8CLG+PwcqGdO3RS3BlnWDLbyq8mFRZ1OpQyOEjMr2CCzlFiDSQSqFp/jsojxULbsYgN2eKzo3zndGlxRKtIT2vzOcAQTgEAbQB7E2TlLXvNvstS1iwIEoN0aoQp2JxPsK1F5vwZ3hGg=="
  29. }