接口说明

调用方：银账通系统

接收方：商户接入系统

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

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

接口名

接口名(method)：bkfunds.order.notify

公共请求参数

名称类型必须描述示例值
app_idstring(32)是接入方appId20210911888888888888888888
methodstring(32)是接口名bkfunds.order.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(16)是机构号100001
store_idstring(16)是门店id20008221
order_idstring(32)是订单交易流水号100010001
sys_seqstring(32)是平台交易流水号2019112011001004330000121536
statusstring(8)是交易状态 0-成功 1-失败0

请求示例

  1. {
  2.     "app_id": "20210911888888888888888888",
  3.     "method": "bkfunds.order.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": "{\"sys_seq\":\"2024010112356888888\",\"order_id\":\"100010001\",\"node_id\":\"100001\",\"status\":\"0\",\"store_id\":\"20008221\"}",
  10.     "sign": "XmrZygmCBA56kqWP9TmQ/r/DVDzjOA+wrNvCWpAQXNYycn3El+D4jpw32V4lyN+gPhcnPsHHm6e3uYfnPuYTE8Owjbcs/ZYbndwFc1qv7crywXnrtKcafQkRzEZD0yK+9HmP7lBpgPFA5lKuftq5B0CEAz9eZ4fOxEKUHT6yMGpYBkStTNXA7Er8pefP59cUCzdV31uS4sNnMS0UagjxJWCVWpYtKEG2iHN6yrnSvZVseDIwDLZKtM3ss4umUdvVi40Tem5vaAmNkaGCwLL4peTIRg7eGzWTbQxDhiONQaT+QCW7o/1pjBd1ttMNcQiFachIXYcpGMC3c+YrrgJsVA=="
  11. }

响应示例

  1. success