接口说明

调用方：商户接入系统

接收方：银账通系统

功能：对分账请求结果进行查询。

请求地址及接口名

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

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

接口名(method)：bkfunds.split.apply.query

公共请求参数

名称类型必须描述示例值
app_idstring(32)是接入方appId20210911888888888888888888
methodstring(32)是接口名bkfunds.split.apply.query
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_apply_seqstring(64)是分账请求流水号1001XP2025010110000001_S01

请求示例

  1. {
  2.     "charset": "utf-8",
  3.     "biz_content": "{\"node_id\":\"00025633\",\"split_apply_seq\":\"1001XP2025010110000001_S01\"}",
  4.     "method": "bkfunds.split.apply.query",
  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. }

公共响应参数

名称类型必须描述示例值
request_idstring是每次请求唯一id4e770f101c9a4191bfd4609d26c6e0bd
codeinteger是返回码10000
msgstring是返回信息success
sub_codestring是请求失败返回的子错误码isv.invalid-app-key
sub_msgstring是请求失败返回的子错误信息无效的app_id参数
signstring是响应参数的签名串XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

code = 10000 仅代表查询成功，实际状态需要看业务数据 data.status 字段

业务响应参数

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

data 业务数据 (JSONObject)

名称类型必须描述示例值
statusinteger是状态: 0-失败，1-成功，6-处理中，9-待处理1
status_descstring否状态描述成功
split_detail_listJSONArray否分账明细列表　

状态说明
通联浙商的分账请求发起成功后状态为待处理，分账执行发起之后状态会变为处理中

split_detail_list 分账明细列表 (JSONArray)

名称类型必须描述示例值
transfer_trade_nostring是分账明细流水FT73020250123103030216
payee_typestring是分账接收方类型：MERCHANT-分账商户，SELF-自留，FEE-手续费MERCHANT
merchant_idstring是接收方翼码商户号
“SELF”类型时为门店绑定的商户号
“FEE”类型时为手续费的商户号		1000000001025
amountinteger是分账金额，单位：分1000
statusinteger是状态: 0-失败，1-成功1

响应示例

  1. {
  2.     "bkfunds_split_apply_query_response": {
  3.         "request_id": "openapi_df2f3932cd88441781b167e76039f642",
  4.         "code": 10000,
  5.         "data": {
  6.             "status": 1,
  7.             "status_desc": "成功",
  8.             "split_detail_list": [
  9.                 {
  10.                     "transfer_trade_no": "FT73020250123103030216",
  11.                     "payee_type": "MERCHANT",
  12.                     "merchant_id": "1000000001026",
  13.                     "amount": 1000,
  14.                     "status": 1,
  15.                     "status_desc": "成功"
  16.                 },
  17.                 {
  18.                     "transfer_trade_no": "FT73120250123103030216",
  19.                     "payee_type": "SELF",
  20.                     "merchant_id": "1000000001025",
  21.                     "amount": 2000,
  22.                     "status": 1,
  23.                     "status_desc": "成功"
  24.                 },
  25.                 {
  26.                     "transfer_trade_no": "FT73220250123103030216",
  27.                     "payee_type": "FEE",
  28.                     "merchant_id": "1000000001024",
  29.                     "amount": 100,
  30.                     "status": 1,
  31.                     "status_desc": "成功"
  32.                 }
  33.             ]
  34.         },
  35.         "success": true
  36.     },
  37.     "sign": "cSkhGHI413Ob77ixs4HQr4MKah+tLGJVnPuOm7lxj5C+ZK768w9ykhRZs0OE7zc9DVEJjDCHSZxD7hH/bSefnarx8scKnevS9LvQ4ksGrtWkbljnP0wbgtxWPoq8pYO2F6PNhQTXuYarQC++VJFT3l/vsC7tbNxvtP74orgwi68C8jxIhrBlF5H2FBsproWrlCTNo0E75kY8CLG+PwcqGdO3RS3BlnWDLbyq8mFRZ1OpQyOEjMr2CCzlFiDSQSqFp/jsojxULbsYgN2eKzo3zndGlxRKtIT2vzOcAQTgEAbQB7E2TlLXvNvstS1iwIEoN0aoQp2JxPsK1F5vwZ3hGg=="
  38. }