业务说明

用于获取平台下所有用户的余额数据，非实时数据，15分钟更新一次

交易请求报文

JSON:

  1. {
  2.     "request_type": "account_balance_mget_request",
  3.     "isspid": "00058307",
  4.     "pos_seq": "20230620141255693",
  5.     "system_id": "8888",
  6.     "sign": "BF84A2679EA7C7AD72F3F8C8483C744B"
  7. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <request_type>account_balance_mget_request</request_type>
  4.     <isspid>00058307</isspid>
  5.     <pos_seq>20230620141255693</pos_seq>
  6.     <system_id>8888</system_id>
  7. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节		可选
request_type请求类型String(32)固定值：account_balance_mget_request必填
isspid商户号String(8)翼码商户号，由翼码提供必填
pos_seq请求流水号String(32)仅用于方便日志查询时作为唯一标识可空
system_id系统平台号String(4)由翼码提供必填

交易返回报文

JSON:

  1. {
  2.     "response_type": "account_balance_mget_response",
  3.     "isspid": "00058307",
  4.     "pos_seq": "20230620141255693",
  5.     "trans_time": "20230620141355",
  6.     "list": [
  7.         {
  8.             "merchant_id": 1000066,
  9.             "type": "01",
  10.             "balance_amt": 0,
  11.             "avl_amt": 0,
  12.             "frz_amt": 0,
  13.             "control_amt": 0,
  14.             "last_avl_amt": 0,
  15.             "status": "N",
  16.             "update_time": "2023-06-20 14:00:03"
  17.         },
  18.         {
  19.             "merchant_id": 1000067,
  20.             "type": "01",
  21.             "balance_amt": 0,
  22.             "avl_amt": 0,
  23.             "frz_amt": 0,
  24.             "control_amt": 0,
  25.             "last_avl_amt": 0,
  26.             "status": "N",
  27.             "update_time": "2023-06-20 14:00:03"
  28.         }
  29.     ],
  30.     "result": {
  31.         "id": "0000",
  32.         "comment": "查询成功"
  33.     },
  34.     "sign": "91B1DD5554468AD08E7FC7907FE7F8F3"
  35. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <response_type>account_balance_mget_response</response_type>
  4.     <isspid>00058307</isspid>
  5.     <pos_seq>20230620141255693</pos_seq>
  6.     <trans_time>20230620141355</trans_time>
  7.     <list><![CDATA[
  8.     [
  9.         {
  10.             "merchant_id": 1000066,
  11.             "type": "01",
  12.             "balance_amt": 0,
  13.             "avl_amt": 0,
  14.             "frz_amt": 0,
  15.             "control_amt": 0,
  16.             "last_avl_amt": 0,
  17.             "status": "N",
  18.             "update_time": "2023-06-20 14:00:03"
  19.         },
  20.         {
  21.             "merchant_id": 1000067,
  22.             "type": "01",
  23.             "balance_amt": 0,
  24.             "avl_amt": 0,
  25.             "frz_amt": 0,
  26.             "control_amt": 0,
  27.             "last_avl_amt": 0,
  28.             "status": "N",
  29.             "update_time": "2023-06-20 14:00:03"
  30.         }
  31.     ]
  32.     ]]>
  33.     </list>
  34.     <result>
  35.         <id>0000</id>
  36.         <comment>查询成功</comment>
  37.     </result>
  38. </business_trans>

交易返回报文说明

标准接口会因业务升级需要而新增节点，请在解析返回报文时避免新增未知节点产生的程序出错！

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节		可选
response_type返回类型String(32)固定值：account_balance_mget_response必填
isspid商户号String(8)翼码商户号，由翼码提供必填
pos_seq请求流水号String(32)和请求报文相同可空
trans_time接口返回时间String(14)接口返回时间，格式：yyyyMMddHHmmss必填
list数据列表JSONArray当使用xml格式报文时，此字段为JSONString并使用CDATA标签包裹可空
result
->id		响应码String(4)0000：查询成功
其它为失败，错误信息说明见“响应码解释”字段		必填
result
->comment		响应码解释String(64)响应码对应中文注解，用于显示提示必填

标准接口会因业务升级需要而新增节点，请在解析返回报文时避免新增未知节点产生的程序出错！

list 数据列表

JSON节点类型说明是否必填范例
merchant_idInteger分账商户id必填1000066
typeString账户类型：01-基本户 02-现金户 03-延时户 04-钱包户 05-充值户 06-微信延时户 09-营销户必填01
balance_amtInteger账户余额(分)，可用余额+冻结余额必填0
avl_amtInteger可用余额(分)必填0
frz_amtInteger冻结余额(分)必填0
control_amtInteger管控金额(分)
该金额包含在冻结金额中		必填0
last_avl_amtInteger昨日日终余额(分)必填0
statusString状态：N-正常 C-关闭 F-冻结 D-销户必填N
update_timeString数据更新时间，格式：yyyy-MM-dd HH:mm:ss必填2023-06-20 14:00:03