接口说明

调用方：商户接入系统

接收方：银账通系统

功能：查询单笔交易的状态

请求地址及接口名

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

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

接口名(method)：bkfunds.balance.pay.query

公共请求参数

名称类型必须描述示例值
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”}

业务请求参数

名称类型必须描述示例值
node_idstring(8)否机构号00025633
trade_nostring(64)是银行流水号2025062010192845769

范例：

  1. {
  2.   "node_id": "00061967",
  3.   "trade_no": "0111325062010252135287"
  4. }

请求示例

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

公共响应参数

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

业务响应参数 data

名称类型必须描述示例值
trade_timestring否交易时间
node_idstring否平台号
node_namestring否平台名称
platform_nostring否平台流水号
ym_trade_nostring否翼码流水号
trade_nostring否银行流水号
total_amountstring否交易金额(分)
feestring否手续费
trade_typestring否交易类型, p=支付, r=退款
payer_merchant_idstring否付款方平台商户号
payer_cloud_merchant_idstring否付款方渠道商户号
payer_store_nostring否付款方自定义门店号
payer_typestring否付款方账户类型 0-收款账户 1-付款账户
payee_merchant_idstring否收款方平台商户号
payee_cloud_merchant_idstring否收款方渠道商户号
payee_store_nostring否收款方自定义门店号
payee_typestring否收款方账户类型 0-收款账户 1-付款账户
arrive_timestring否到账时间 T0 当天到账 T1 次日到账
real_amountstring否实际到账金额(分)
statusstring否状态: 0=失败, 1=成功, 2=已退款, 9=处理中, n=待发送申请
status_descstring否状态描述
finish_timestring否完成时间
before_amountstring否交易前账户余额(分)

响应示例

  1. {
  2.     "bkfunds_balance_pay_query_response": {
  3.         "request_id": "openapi_c7ee5fe4348e4d0a990d192366032ea9",
  4.         "code": 10000,
  5.         "data": {
  6.             "id": 9,
  7.             "trade_time": "2025-06-24 13:59:45",
  8.             "node_id": "00061967",
  9.             "node_name": "18823657777",
  10.             "channel": "02",
  11.             "platform_no": "111",
  12.             "ym_trade_no": "2025062413594476280",
  13.             "trade_no": "2025062413594476280",
  14.             "total_amount": 10,
  15.             "fee": 0,
  16.             "trade_type": "p",
  17.             "payer_merchant_id": 4458000000141079,
  18.             "payer_cloud_merchant_id": "4609000000021008",
  19.             "payer_store_no": "amy99a",
  20.             "payer_type": "1",
  21.             "payee_merchant_id": 1000000001123,
  22.             "payee_cloud_merchant_id": "4609000000001077",
  23.             "payee_store_no": "amy99b",
  24.             "payee_type": "2",
  25.             "arrive_time": "T0",
  26.             "real_amount": 0,
  27.             "status": "1",
  28.             "status_desc": "交易成功",
  29.             "finish_time": "2025-06-24 13:59:45",
  30.             "before_amount": 99919834,
  31.             "created_at": "2025-06-24 13:59:44",
  32.             "created_by": 1
  33.         },
  34.         "success": true
  35.     },
  36.     "sign": "HmzOV+I2+NGXn7yjLJ6VJ4NzNDtnjmtedWIXiPYSirDOu5kdaIVhFvAxzaKnU959S6HqoIyQFbxnb2PjgadUcA6ISpVEnN6MF0k3p/d1mzl1zCbV2lUlirk0v5vtkln1FgVX/xDmNyC5W/oJdzUXiaRLBQo/L9lIzdfDckrQB9nK/VPXleFL25sdchTeAB22LyiuGeLD9Xy+lB/cNp+W6wXc2W8Nv4djT7f0fXjpy1GZBD6GvHr3nEmm5iktJ2/zNdZFpCxfVpL2JuN8haL9kSWMRY6WJFIRijj1bP0af/NxYd00uK3kMYkLwGJhZdOk+5gAHyU8SgSaL2ySNMH0Ng=="
  37. }