接口说明

调用方：银账通系统

接收方：商户接入系统

注意：商户接收到通知处理成功后需响应字符串“success”，其他响应翼码系统认为通知失败会继续通知。接收失败会重试3次，间隔3分钟。

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

POST请求，Content-Type为application/json

接口名

接口名(method)：bkfunds.acct.transfer.notify

公共请求参数

名称类型必须描述示例值
app_idstring(32)是接入方appId20210911888888888888888888
methodstring(32)是接口名bkfunds.acct.transfer.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”}

业务请求参数

名称类型必须描述示例值
channelstring(2)是银行渠道：02-平安银行，04-工商银行02
node_idstring(8)是机构号00026713
record_idstring(32)是来账记录ID1234
trans_timestring(19)是交易时间，格式：yyyy-MM-dd HH:mm:ss2025-06-01 15:20:33
channel_trade_nostring(64)是银行流水号10000000001
merchant_namestring(255)否收款方商户名称
有关联到扣款卡才有值		商户名称
merchant_idstring(32)否收款方翼码商户号
有关联到扣款卡才有值		10000000123
cloud_merchant_idstring(64)否收款方通道商户号
有关联到扣款卡才有值		4204564615348
in_acct_namestring(100)是收款方账户户名收款方账户户名
in_acct_bank_namestring(120)否收款方开户行名称xxxx银行
in_acct_nostring(32)是收款方账户15489516846
trans_amountstring(16)是交易金额，单位：分100000
ccy_codestring(5)是结算币种：RMB-人民币RMB
feestring(16)否手续费，单位：分
银行渠道为工行时为空		100
post_feestring(16)否邮电费，单位：分
银行渠道为工行时为空		100
bind_statusstring(1)是绑定状态：0-未绑定，1-已绑定1
deduct_statusstring(1)是扣款状态：0-未扣款，1-已扣款，6-处理中6
deduct_channel_trade_nostring(64)否扣款银行流水号10000000002
out_acct_namestring(100)是付款方账户名称付款方账户名称
out_acct_bank_namestring(120)否付款方开户行名称xxxx银行
out_acct_nostring(32)是付款方账户624615616476846548
host_flow_nostring(32)是银行主机流水号
银行渠道为工行时为空		300000000001
host_tx_datestring(10)是记账日期，格式：yyyy-MM-dd
银行渠道为工行时为空		2025-06-01
reverse_flagstring(1)否被冲正标志：0-无关，1-被冲正，2-冲正
银行渠道为工行时为空		0
use_exstring(300)否资金用途资金用途
remarkstring(100)否备注备注
store_liststring否商户号绑定的门店列表，JSONArray
有关联到扣款卡才有值		　

store_list 商户号绑定的门店列表 (JSONArray)

名称类型必须描述示例值
store_idstring(50)是门店自定义编号S0001
store_namestring(100)是门店名称门店0001

请求示例

  1. {
  2.     "app_id": "20210911888888888888888888",
  3.     "method": "bkfunds.acct.transfer.notify",
  4.     "version": "1.0",
  5.     "charset": "utf-8",
  6.     "format": "json",
  7.     "sign_type": "RSA2",
  8.     "timestamp": "2024-04-29 17:14:51",
  9.     "biz_content": "{\"channel\":\"02\",\"node_id\":\"00026713\",\"record_id\":\"1234\",\"trans_time\":\"2025-06-01 15:20:33\",\"channel_trade_no\":\"10000000001\",\"merchant_name\":\"商户名称\",\"merchant_id\":\"10000000123\",\"cloud_merchant_id\":\"4204564615348\",\"in_acct_name\":\"收款方账户户名\",\"in_acct_bank_name\":\"xxxx银行\",\"in_acct_no\":\"15489516846\",\"trans_amount\":\"100000\",\"ccy_code\":\"RMB\",\"fee\":\"100\",\"post_fee\":\"100\",\"bind_status\":\"1\",\"deduct_status\":\"6\",\"deduct_channel_trade_no\":\"10000000002\",\"out_acct_name\":\"付款方账户名称\",\"out_acct_bank_name\":\"xxxx银行\",\"out_acct_no\":\"624615616476846548\",\"host_flow_no\":\"300000000001\",\"host_tx_date\":\"2025-06-01\",\"reverse_flag\":\"0\",\"use_ex\":\"资金用途\",\"remark\":\"备注\",\"store_list\":\"[{\\\"store_id\\\":\\\"S0001\\\",\\\"store_name\\\":\\\"门店0001\\\"},{\\\"store_id\\\":\\\"S0002\\\",\\\"store_name\\\":\\\"门店0002\\\"}]\"}}",
  10.     "sign": "XmrZygmCBA56kqWP9TmQ/r/DVDzjOA+wrNvCWpAQXNYycn3El+D4jpw32V4lyN+gPhcnPsHHm6e3uYfnPuYTE8Owjbcs/ZYbndwFc1qv7crywXnrtKcafQkRzEZD0yK+9HmP7lBpgPFA5lKuftq5B0CEAz9eZ4fOxEKUHT6yMGpYBkStTNXA7Er8pefP59cUCzdV31uS4sNnMS0UagjxJWCVWpYtKEG2iHN6yrnSvZVseDIwDLZKtM3ss4umUdvVi40Tem5vaAmNkaGCwLL4peTIRg7eGzWTbQxDhiONQaT+QCW7o/1pjBd1ttMNcQiFachIXYcpGMC3c+YrrgJsVA=="
  11. }

响应示例

  1. success