接口说明

调用方：商户接入系统

接收方：银账通系统

功能：对分账请求进行退回。

请求地址及接口名

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

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

接口名(method)：bkfunds.split.refund

公共请求参数

名称类型必须描述示例值
app_idstring(32)是接入方appId20210911888888888888888888
methodstring(32)是接口名bkfunds.split.refund
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_refund_seqstring(64)是分账退回流水号
机构号下唯一，不可重复使用，且不能与分账请求流水重复		1001XP2025010110000001_S01_R01
split_apply_seqstring(64)否分账请求流水号
分账请求流水号与翼码分账总流水号二选一必填		1001XP2025010110000001_S01
transfer_idstring(64)否翼码分账总流水号
分账请求流水号与翼码分账总流水号二选一必填		7382
split_infoJSONArray是分账信息　

split_info 分账信息 (JSONArray)

名称类型必须描述示例值
amountinteger是分账退回金额，单位：分1000
payee_typestring是分账接收方类型：MERCHANT-分账商户，STORE-分账门店，SELF-自留，FEE-手续费
仅平安通道的交易支持使用“FEE”类型
其他通道需扣除手续费		MERCHANT
merchant_idstring否分账接收方商户号，仅当 分账接收方类型 = MERCHANT 时有效且必填1000000001025
store_idstring否分账接收方门店号，自定义门店号，仅当 分账接收方类型 = STORE 时有效且必填S0001

退回不支持使用 账户类型(account_type) ，退回的账户直接取分账请求的账户，原账户原退

范例：

  1. [
  2.     {
  3.         "payee_type": "SELF",
  4.         "amount": 7000
  5.     },
  6.     {
  7.         "payee_type": "FEE",
  8.         "amount": 100
  9.     },
  10.     {
  11.         "payee_type": "MERCHANT",
  12.         "merchant_id": "1000000001025",
  13.         "amount": 1000
  14.     },
  15.     {
  16.         "payee_type": "MERCHANT",
  17.         "merchant_id": "1000000001025",
  18.         "amount": 2000
  19.     },
  20.     {
  21.         "payee_type": "STORE",
  22.         "store_id": "S0001",
  23.         "amount": 2000
  24.     }
  25. ]

请求示例

  1. {
  2.     "charset": "utf-8",
  3.     "biz_content": "{\"node_id\":\"00025633\",\"split_refund_seq\":\"1001XP2025010110000001_S01_R01\",\"split_apply_seq\":\"1001XP2025010110000001_S01\",\"split_info\":[{\"payee_type\":\"SELF\",\"amount\":7000},{\"payee_type\":\"FEE\",\"amount\":100},{\"payee_type\":\"MERCHANT\",\"merchant_id\":\"1000000001025\",\"amount\":1000},{\"payee_type\":\"MERCHANT\",\"merchant_id\":\"1000000001025\",\"amount\":2000},{\"payee_type\":\"STORE\",\"store_id\":\"S0001\",\"amount\":2000}]}",
  4.     "method": "bkfunds.split.refund",
  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-28 15:09:29"
  11. }

公共响应参数

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

业务响应参数

名称类型必须描述示例值
dataJSONObject否业务数据本接口返回空
successboolean否是否成功true

code = 10000 仅代表分账退回接口申请成功，分账结果需调用分账退回查询确认

响应示例

  1. {
  2.     "bkfunds_split_refund_response": {
  3.         "request_id": "openapi_a020aac2e3884430bb0a65170da96fd7",
  4.         "code": 10000,
  5.         "success": true
  6.     },
  7.     "sign": "J7eN5aYaMSUmfrWzsLKjutXU8ktT5hGAQAw/eGIy3Q57RcCp2JMFli8si2o9WaScuRDOjZYKrlXKTWv7eT3Ie3XLZJc3TfUypGfZMqvHy1pzBA8Yt+Tt+ckND1mLHWrDqElTsgjFpWWCxG1fbnUhM0rcbuf19NVzJb1QB2T8yb9nwkbUU05SctxZPojkE7BSz6Hilp8ARIvusCdy7oyK5XrOKxaUqSIUNX68fimy10yBevIAJaOFAGZH9wyMJLfLSHtNj6295EbJUSH9XR5stx8w9gufr4S6hG46liN5lSh6qwmYlYrtOCVe41Pz9Z54ZmXNPkviAtNJ/Z/TWVWvBw=="
  8. }