接口说明

调用方：商户接入系统

接收方：银账通系统

功能：提现记录查询

请求地址及接口名

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

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

接口名(method)：bkfunds.withdraw.list

公共请求参数

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

业务请求参数

名称类型必须描述示例值
sso_node_idnumber是机构ID2001
begin_trade_datestring否提现时间-开始, yyyy-MM-dd2025-01-01
end_trade_datestring否提现时间-结束, yyyy-MM-dd2025-01-31
merchant_namestring否商户名称xx物业
merchant_idnumber否翼码商户号100001
account_sub_typestring否账户类型 0-收款账户 1-付款账户1
cloud_merchant_idstring否通道商户号CM202501010001
cloud_order_nostring否提现订单号WD202501010001
statusstring否状态: 0=失败, 1=成功, n=处理中1
withdrawal_methodstring否提现类型: 0=自动提现, 1=手动提现0
card_typestring否结算卡标识: 0-提现卡，1-费用卡，2-其他卡0
page_numnumber否页数(默认1)1
page_sizenumber否每页数量(默认10)10

范例：

  1. {
  2.   "page_num": 0,
  3.   "page_size": 10,
  4.   "sso_node_id": 1001
  5. }

请求示例

  1. {
  2.     "charset": "utf-8",
  3.     "biz_content": "{
  4.   "page_num": 0,
  5.   "page_size": 10,
  6.   "node_id": 1001
  7. }",
  8.     "method": "bkfunds.withdraw.query",
  9.     "format": "json",
  10.     "sign": "bP6dfs2LgvpxhyeTS+VwfSp+26Pgi6VPLagYIGx5ENL5shQmXWBel56nxkDi22hoopKuqO3FbomxIuFMuMPDWuFzJCHLW2O9yTut+94Rx0f8ICikYVanMAhsaIIeMx0g9AdZzqP2IOou0xD7udmeXmCZqKw/h73+VzXM5aRtSPCeQI7zlKd2wyKmhvjdc9ujXZ5phNeZgdtjLm5tI2Xnq+XIh+6shnRS+4Q1LFo6ubgBsEBHpVo4dsJJSknj4q+9hc38nmpPUNLPIV154Z+WiZsAllXaHunrt5lsnixdrqr3VkkDwpfkH4JzZS0hIZi7CsfhePWgra1GfI/BbYRvwQ==",
  11.     "app_id": "202404221232028501746384896",
  12.     "sign_type": "RSA2",
  13.     "version": "1.0",
  14.     "timestamp": "2024-04-2815:09:29"
  15. }

公共响应参数

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

业务响应参数 data

名称类型必须描述示例值
trade_nostring否流水号
merchant_idLong否商户号
merchant_namestring否商户名称
confirm_trade_nostring否确认流水号
cloud_order_nostring否提现订单号
total_amountLong否金额(分)
total_amount_strstring否提现金额(元)
real_amountLong否实际到账金额(分)
real_amount_strstring否实际到账金额(分)
currencystring否币种
withdraw_timeDate否提现时间
withdraw_time_strstring否提现时间
finish_timeDate否提现完成时间
platform_feeLong否手续费(分)
platform_fee_currencystring否手续费币种
statusstring否状态: 0=失败, 1=成功, 2=申请成功(待确定), 3=申请失败, 4=确认失败, 5=提现处理中(确认成功), 8=申请处理中, 9=待发申请, n=回调处理中
status_descstring否状态
withdrawal_methodstring否提现类型: 0=自动提现, 1=手动提现
bank_card_nostring否银行卡号
bank_cert_namestring否银行户名
remarkstring否提现描述
created_atDate否新增时间
updated_atDate否更新时间
node_idInteger否平台账号
node_namestring否平台名称
channelstring否渠道: 01=网商
created_byLong否创建人
updated_byLong否更新人
electronic_statusstring否电子凭证状态: 0=未发起, 1=处理中, 2=成功, 3=失败, n=回调处理中
electronic_urlstring否电子凭证地址
org_trade_nostring否原提现订单号
org_cloud_order_nostring否原提现订单号
cloud_merchant_idstring否通道商户号
card_typestring否结算卡标识 0-提现卡 1-费用卡 2-其他卡
account_sub_typestring否账户类型 0-收款账户 1-付款账户

响应示例

  1. {
  2.     "bkfunds_balance_pay_query_response": {
  3.         "request_id": "openapi_c7ee5fe4348e4d0a990d192366032ea9",
  4.         "code": 10000,
  5.          "data": {
  7.     "total": 26,
  8.     "list": [
  9.         {
  10.             "currency": "CNY",
  11.             "status": "1",
  12.             "remark": "平安银行自动提现",
  13.             "trade_no": "51220250723113013942",
  14.             "merchant_id": 1000000001210,
  15.             "merchant_name": "平安测试IV111哈哈哈",
  16.             "confirm_trade_no": null,
  17.             "cloud_order_no": "2507231980453823",
  18.             "total_amount": 1,
  19.             "total_amount_str": "0.01",
  20.             "real_amount": 0,
  21.             "real_amount_str": "0.00",
  22.             "withdraw_time": "2025-07-23 11:30:14",
  23.             "withdraw_time_str": "20250723 11:30:14",
  24.             "finish_time": "2025-07-23 11:30:14",
  25.             "platform_fee": 0,
  26.             "platform_fee_currency": "CNY",
  27.             "status_desc": "成功",
  28.             "withdrawal_method": "0",
  29.             "bank_card_no": "15000101603827",
  30.             "bank_cert_name": "平安测试IV1",
  31.             "created_at": "2025-07-23 11:30:13",
  32.             "updated_at": "2025-07-23 11:30:14",
  33.             "node_id": 1114,
  34.             "node_name": "18823656665",
  35.             "channel": "02",
  36.             "created_by": null,
  37.             "updated_by": null,
  38.             "electronic_status": "0",
  39.             "electronic_url": null,
  40.             "org_trade_no": null,
  41.             "org_cloud_order_no": null,
  42.             "cloud_merchant_id": "4609000000051017",
  43.             "card_type": "0",
  44.             "account_sub_type": "1"
  45.         }
  46.     ],
  47.     "pages": 3,
  48.     "page_num": 1,
  49.     "page_size": 10,
  50.     "size": 10,
  51.     "start_row": 1,
  52.     "end_row": 10,
  53.     "pre_page": 0,
  54.     "next_page": 0,
  55.     "is_first_page": true,
  56.     "is_last_page": false,
  57.     "has_previous_page": false,
  58.     "has_next_page": true,
  59.     "navigate_pages": 0,
  60.     "navigatepage_nums": [],
  61.     "navigate_firse_page": 0,
  62.     "navigate_last_page": 0
  64.   },
  65.         "success": true
  66.     },
  67.     "sign": "HmzOV+I2+NGXn7yjLJ6VJ4NzNDtnjmtedWIXiPYSirDOu5kdaIVhFvAxzaKnU959S6HqoIyQFbxnb2PjgadUcA6ISpVEnN6MF0k3p/d1mzl1zCbV2lUlirk0v5vtkln1FgVX/xDmNyC5W/oJdzUXiaRLBQo/L9lIzdfDckrQB9nK/VPXleFL25sdchTeAB22LyiuGeLD9Xy+lB/cNp+W6wXc2W8Nv4djT7f0fXjpy1GZBD6GvHr3nEmm5iktJ2/zNdZFpCxfVpL2JuN8haL9kSWMRY6WJFIRijj1bP0af/NxYd00uK3kMYkLwGJhZdOk+5gAHyU8SgSaL2ySNMH0Ng=="
  68. }