接口说明

调用方:银账通系统

接收方:商户接入系统

注意:商户接收到通知处理成功后需响应字符串“success”,其他响应翼码系统认为通知失败会继续通知。

注意:同样的通知可能会多次发送给商户系统,商户系统必须能够正确处理重复的通知。

接口名

接口名(method):bkfunds.split.execute.notify

公共请求参数

名称类型必须描述示例值
app_idstring(32)接入方appId20210911888888888888888888
methodstring(32)接口名bkfunds.split.execute.notify
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
split_execute_seqstring(64)分账执行流水号1001X20250415_E0001
execute_datestring(10)分账执行交易日期2025-04-15
statusinteger状态:1-成功,0-失败1
status_descstring状态描述成功
result_file_urlstring清分结果文件下载地址https://fzxt-yzt.imageco.cn/file/split_check/20241113/00058859/CZB00018012024111301.txt

请求示例

  1. {
  2. "charset": "utf-8",
  3. "biz_content": "{\"node_id\":\"00025633\",\"split_execute_seq\":\"1001X20250415_E0001\",\"execute_date\":\"2025-04-15\",\"status\":1,\"status_desc\":\"成功\",\"result_file_url\":\"https://fzxt-yzt.imageco.cn/file/split_check/20241113/00058859/CZB00018012024111301.txt\"}",
  4. "method": "bkfunds.split.execute.notify",
  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. }

响应示例

  1. success