接口说明
调用方:银账通系统
接收方:商户接入系统
注意:商户接收到通知处理成功后需响应字符串“success”,其他响应翼码系统认为通知失败会继续通知。
注意:同样的通知可能会多次发送给商户系统,商户系统必须能够正确处理重复的通知。
接口名
接口名(method):bkfunds.split.execute.notify
公共请求参数
名称 | 类型 | 必须 | 描述 | 示例值 |
---|---|---|---|---|
app_id | string(32) | 是 | 接入方appId | 20210911888888888888888888 |
method | string(32) | 是 | 接口名 | bkfunds.split.execute.notify |
format | string(16) | 是 | 报文格式,仅支持JSON | json |
charset | string(16) | 是 | 字符编码 | UTF-8 |
sign_type | string(8) | 是 | 签名算法类型,仅支持RSA2 | RSA2 |
timestamp | string(16) | 是 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8。服务端允许客户端请求最大时间误差为10分钟 | 2021-09-11 12:00:00 |
version | string(8) | 是 | 版本号 | 1.0 |
app_auth_token | string(128) | 否 | token | 01c9a4191bfd4609d26 |
sign | string(256) | 是 | 请求参数的签名串 | XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
biz_content | string | 是 | 业务请求参数,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档 | {“file”:””,”type”:”1”} |
业务请求参数
名称 | 类型 | 必须 | 描述 | 示例值 |
---|---|---|---|---|
node_id | string(8) | 是 | 机构号 | 00025633 |
split_execute_seq | string(64) | 是 | 分账执行流水号 | 1001X20250415_E0001 |
execute_date | string(10) | 是 | 分账执行交易日期 | 2025-04-15 |
status | integer | 是 | 状态:1-成功,0-失败 | 1 |
status_desc | string | 否 | 状态描述 | 成功 |
result_file_url | string | 否 | 清分结果文件下载地址 | https://fzxt-yzt.imageco.cn/file/split_check/20241113/00058859/CZB00018012024111301.txt |
请求示例
{
"charset": "utf-8",
"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\"}",
"method": "bkfunds.split.execute.notify",
"format": "json",
"sign": "bP6dfs2LgvpxhyeTS+VwfSp+26Pgi6VPLagYIGx5ENL5shQmXWBel56nxkDi22hoopKuqO3FbomxIuFMuMPDWuFzJCHLW2O9yTut+94Rx0f8ICikYVanMAhsaIIeMx0g9AdZzqP2IOou0xD7udmeXmCZqKw/h73+VzXM5aRtSPCeQI7zlKd2wyKmhvjdc9ujXZ5phNeZgdtjLm5tI2Xnq+XIh+6shnRS+4Q1LFo6ubgBsEBHpVo4dsJJSknj4q+9hc38nmpPUNLPIV154Z+WiZsAllXaHunrt5lsnixdrqr3VkkDwpfkH4JzZS0hIZi7CsfhePWgra1GfI/BbYRvwQ==",
"app_id": "202404221232028501746384896",
"sign_type": "RSA2",
"version": "1.0",
"timestamp": "2024-04-2815:09:29"
}
响应示例
success