分账相关

admin 2026-08-16 17:10:59 赛事日历

分账相关

接口说明请求地址及接口名公共请求参数业务请求参数请求示例公共响应参数业务响应参数data 业务数据 (JSONObject)split_detail_list 分账明细列表 (JSONArray)响应示例接口说明调用方:商户接入系统

接收方:银账通系统

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

请求地址及接口名生产环境:https://fzxt-yzt-openapi.wangcaio2o.com

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

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

公共请求参数名称类型必须描述示例值app_idstring(32)是接入方appId20210911888888888888888888methodstring(32)是接口名bkfunds.split.apply.queryformatstring(16)是报文格式,仅支持JSONjsoncharsetstring(16)是字符编码UTF-8sign_typestring(8)是签名算法类型,仅支持RSA2RSA2timestampstring(16)是时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8。服务端允许客户端请求最大时间误差为10分钟2021-09-11 12:00:00versionstring(8)是版本号1.0app_auth_tokenstring(128)否token01c9a4191bfd4609d26signstring(256)是请求参数的签名串XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXbiz_contentstring是业务请求参数,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档{“file”:””,”type”:”1”}业务请求参数名称类型必须描述示例值node_idstring(8)是机构号00025633split_apply_seqstring(64)是分账请求流水号1001XP2025010110000001_S01请求示例{ "charset": "utf-8", "biz_content": "{\"node_id\":\"00025633\",\"split_apply_seq\":\"1001XP2025010110000001_S01\"}", "method": "bkfunds.split.apply.query", "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-28 15:09:29"}公共响应参数名称类型必须描述示例值request_idstring是每次请求唯一id4e770f101c9a4191bfd4609d26c6e0bdcodeinteger是返回码10000msgstring是返回信息successsub_codestring是请求失败返回的子错误码isv.invalid-app-keysub_msgstring是请求失败返回的子错误信息无效的app_id参数signstring是响应参数的签名串XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXcode = 10000 仅代表查询成功,实际状态需要看业务数据 data.status 字段

业务响应参数名称类型必须描述示例值dataJSONObject否业务数据successboolean否是否成功truedata 业务数据 (JSONObject)名称类型必须描述示例值statusinteger是状态: 0-失败,1-成功,6-处理中,9-待处理1status_descstring否状态描述成功split_detail_listJSONArray否分账明细列表 状态说明通联浙商的分账请求发起成功后状态为待处理,分账执行发起之后状态会变为处理中

split_detail_list 分账明细列表 (JSONArray)名称类型必须描述示例值transfer_trade_nostring是分账明细流水FT73020250123103030216payee_typestring是分账接收方类型:MERCHANT-分账商户,STORE-分账门店,SELF-自留,FEE-手续费MERCHANTmerchant_idstring是接收方翼码商户号“STORE”类型时为分账门店绑定的商户号“SELF”类型时为交易门店绑定的商户号“FEE”类型时为手续费的商户号1000000001025store_idstring否分账接收方门店号,自定义门店号,仅当STORE”类型时有值S0001amountinteger是分账金额,单位:分1000statusinteger是状态:0-失败,1-成功1account_typestring(1)否账户类型:1-收款账户,2-付款账户1分账接收方类型“STORE”相关功能未完成开发

响应示例{ "bkfunds_split_apply_query_response": { "request_id": "openapi_df2f3932cd88441781b167e76039f642", "code": 10000, "data": { "status": 1, "status_desc": "成功", "split_detail_list": [ { "transfer_trade_no": "FT73020250123103030216", "payee_type": "MERCHANT", "merchant_id": "1000000001026", "amount": 1000, "status": 1, "status_desc": "成功", "account_type": "1" }, { "transfer_trade_no": "FT73020250123103030216", "payee_type": "STORE", "merchant_id": "1000000001027", "store_id": "S0001", "amount": 1000, "status": 1, "status_desc": "成功", "account_type": "1" }, { "transfer_trade_no": "FT73120250123103030216", "payee_type": "SELF", "merchant_id": "1000000001025", "amount": 2000, "status": 1, "status_desc": "成功" }, { "transfer_trade_no": "FT73220250123103030216", "payee_type": "FEE", "merchant_id": "1000000001024", "amount": 100, "status": 1, "status_desc": "成功" } ] }, "success": true }, "sign": "cSkhGHI413Ob77ixs4HQr4MKah+tLGJVnPuOm7lxj5C+ZK768w9ykhRZs0OE7zc9DVEJjDCHSZxD7hH/bSefnarx8scKnevS9LvQ4ksGrtWkbljnP0wbgtxWPoq8pYO2F6PNhQTXuYarQC++VJFT3l/vsC7tbNxvtP74orgwi68C8jxIhrBlF5H2FBsproWrlCTNo0E75kY8CLG+PwcqGdO3RS3BlnWDLbyq8mFRZ1OpQyOEjMr2CCzlFiDSQSqFp/jsojxULbsYgN2eKzo3zndGlxRKtIT2vzOcAQTgEAbQB7E2TlLXvNvstS1iwIEoN0aoQp2JxPsK1F5vwZ3hGg=="}