接口说明

调用方：商户接入系统

接收方：银账通系统

功能：到账记录列表查询。

请求地址及接口名

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

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

接口名(method)：bkfunds.acct.arrival.list

公共请求参数

名称类型必须描述示例值
app_idstring(32)是接入方appId20210911888888888888888888
methodstring(32)是接口名bkfunds.acct.arrival.list
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
transfer_date_sstring(10)是到账日期开始，格式：yyyy-MM-dd2025-08-01
transfer_date_estring(10)是到账日期结束，格式：yyyy-MM-dd2025-08-15
page_numinteger否页数，默认11
page_sizeinteger否页数，默认10，最大不超过5020

请求示例

  1. {
  2.     "charset": "utf-8",
  3.     "biz_content": "{\"node_id\":\"00025633\",\"transfer_date_s\":\"2025-08-01\",\"transfer_date_e\":\"2025-08-15\",\"page_num\":1,\"page_size\":20}",
  4.     "method": "bkfunds.acct.arrival.list",
  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

业务响应参数

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

data 业务数据 (JSONObject)

名称类型必须描述示例值
totalinteger是总记录数3
listJSONArray是数据列表
pagesinteger是总页数1
page_numinteger是页码1
page_sizeinteger是每页数量20
sizeinteger是当前页数量3
start_rowinteger是起始行1
end_rowinteger是结束行3
pre_pageinteger是前一页0
next_pageinteger是下一页0
is_first_pageboolean是是否为第一页true
is_last_pageboolean是是否为最后一页true
has_previous_pageboolean是是否有前一页false
has_next_pageboolean是是否有下一页false
navigate_pagesinteger是导航页码数0
navigatepage_numsArray(integer)是所有导航页号
navigate_firse_pageinteger是导航条第一页0
navigate_last_pageinteger是导航条最后一页0
list 数据列表 (JSONArray)
名称类型必须描述示例值
node_idstring是平台号，银账通内部编号，与请求的node_id不一样
注意区分，不需要用到可以忽略		1110
node_namestring是平台名称18800656883红蜻蜓回归测试
transfer_datestring是到账时间，格式：yyyy-MM-dd HH:mm:ss2024-12-17 00:00:00
trans_nostring是入账流水号2412171493237178
typestring是支付渠道：1-美团，2-饿了么，3-其他3
amountdouble是到账金额，单位：元120.0
funds_cyclestring否归属账期
payee_card_nostring是账户号15000101705327
statusstring是状态：0-初始，6-处理中，1-对账成功，2-已处理，3-对账失败，4-已确认，5-分账失败，a-所有状态，d-已分账除外所有0
channelstring是分账通道：01-网商，02-平安02
in_acct_typestring是入账类型：03-资金归集03
payee_card_namestring是入账账户名称浙江爱依迪贸易有限公司
payer_card_namestring是付款方银行名称平安银行总行

响应示例

  1. {
  2.     "bkfunds_acct_arrival_list_response": {
  3.         "request_id": "openapi_f01a63237fd74c24967144be4a375013",
  4.         "code": 10000,
  5.         "data": {
  6.             "total": 3,
  7.             "list": [
  8.                 {
  9.                     "node_id": "1110",
  10.                     "node_name": "18800656883红蜻蜓回归测试",
  11.                     "transfer_date": "2024-12-17 00:00:00",
  12.                     "trans_no": "2412171493237178",
  13.                     "type": "3",
  14.                     "amount": 120.0,
  15.                     "funds_cycle": "",
  16.                     "payee_card_no": "15000101705327",
  17.                     "status": "0",
  18.                     "channel": "02",
  19.                     "in_acct_type": "03",
  20.                     "payee_card_name": "浙江爱依迪贸易有限公司",
  21.                     "payer_card_name": "平安银行总行"
  22.                 },
  23.                 {
  24.                     "node_id": "1110",
  25.                     "node_name": "18800656883红蜻蜓回归测试",
  26.                     "transfer_date": "2024-12-17 00:00:00",
  27.                     "trans_no": "2412171493237506",
  28.                     "type": "3",
  29.                     "amount": 1500.0,
  30.                     "funds_cycle": "",
  31.                     "payee_card_no": "15000101705327",
  32.                     "status": "0",
  33.                     "channel": "02",
  34.                     "in_acct_type": "03",
  35.                     "payee_card_name": "浙江爱依迪贸易有限公司",
  36.                     "payer_card_name": "平安银行总行"
  37.                 },
  38.                 {
  39.                     "node_id": "1110",
  40.                     "node_name": "18800656883红蜻蜓回归测试",
  41.                     "transfer_date": "2024-12-17 00:00:00",
  42.                     "trans_no": "2412171493237634",
  43.                     "type": "3",
  44.                     "amount": 2300.0,
  45.                     "funds_cycle": "",
  46.                     "payee_card_no": "15000101705327",
  47.                     "status": "0",
  48.                     "channel": "02",
  49.                     "in_acct_type": "03",
  50.                     "payee_card_name": "浙江爱依迪贸易有限公司",
  51.                     "payer_card_name": "平安银行总行"
  52.                 }
  53.             ],
  54.             "pages": 1,
  55.             "page_num": 1,
  56.             "page_size": 20,
  57.             "size": 3,
  58.             "start_row": 1,
  59.             "end_row": 3,
  60.             "pre_page": 0,
  61.             "next_page": 0,
  62.             "is_first_page": true,
  63.             "is_last_page": true,
  64.             "has_previous_page": false,
  65.             "has_next_page": false,
  66.             "navigate_pages": 0,
  67.             "navigatepage_nums": [],
  68.             "navigate_firse_page": 0,
  69.             "navigate_last_page": 0
  70.         },
  71.         "success": true
  72.     },
  73.     "sign": "XcMLOYGk1QYHisVCR+zqq5DmzLoBwLcaNzKEk0Q4aJLtXrFXOnTDmvj1fTpmOhTy/v3g9TtbcgWdhyOVpr3tAn7oE2lRai6WX0K/7OLmA4ObeaU5ll/0SVuXnROfseENOYW1PJ7tuenUb9eO7RwCMM2bOarpwtnkY9UtzL39xSEuV55xlhH10gZO4TBssB/ItJ7sEX//T5ynRSX0YkzZ7K+tmhHv17QeTBDMCzvAmdhW9k614qzxl8Cte2vLK93Kl2so5jUvB9n5qoVWp1K8kiA1CqMRi73hZ4/EtKaiNgFDQ5PcBRGJ4kwBCV+zksjEjW1V4gBsm10W4Lby2LvcbA=="
  74. }