接口说明

调用方：商户接入系统

接收方：银账通系统

功能：查询单笔划转的结果，支持平安银行、工商银行渠道。

请求地址及接口名

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

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

接口名(method)：bedl.ent.single.transfer.query

公共请求参数

名称类型必须描述示例值
app_idstring(32)是接入方appId20210911888888888888888888
methodstring(32)是接口名bedl.ent.single.transfer.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
third_voucher_nostring(20)是转账凭证号
企业单笔资金划转请求的转账凭证号		20250601151617000001

请求示例

  1. {
  2.     "charset": "utf-8",
  3.     "biz_content": "{\"node_id\":\"00025633\",\"third_voucher_no\":\"20250601151617000001\"}",
  4.     "method": "bedl.ent.single.transfer.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-28 15: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)

名称类型必须描述示例值
channelstring(2)是银行渠道：02-平安银行，04-工商银行02
node_idstring(8)是机构号00025633
third_voucher_nostring(20)是转账凭证号20250601151617000001
ym_trade_nostring(20)是翼码流水号AT111300000000000001
channel_trade_nostring(20)是渠道流水号1111111111
custom_nostring(20)否自定义编号，与单笔划转请求相同20250601151617000001
ccy_codestring(5)是货币类型：RMB-人民币RMB
store_idstring(32)否付款方门店号，与单笔划转请求相同S0001
out_acct_nostring(20)是付款方账户15000100714429
out_acct_namestring(60)是付款方账户名称科技有限公司
in_acct_nostring(20)是收款方账户15000100714430
in_acct_namestring(60)是收款方账户名称科技有限公司
in_acct_bank_namestring(60)是收款方账户开户行名称
trans_amountlong是转出金额，单位：分1000
statusint是交易状态：0-失败，1-成功，6-处理中
处理中需调用查询接口确认。		1
status_descstring(100)是状态描述交易成功
union_flagstring(1)是行内跨行标志：1-行内转账，0-跨行转账1
feelong是手续费，单位：分
转账手续费预算，实际手续费用以实际扣取的为准。
银行渠道为工行时为空		0
post_feelong否邮电费，单位：分
银行渠道为工行时为空		0
host_flow_nostring(32)否银行主机流水
银行记账流水号，转账成功后，银行返回的流水号。
银行渠道为工行时为空		111111111111111
host_tx_datestring(10)否记账日期
银行交易成功后的记账日期，仅对行内实时转账交易有效，格式：YYYY-MM-DD。
银行渠道为工行时为空		2025-06-01
is_backint否转账退票标志：0-未退票 1-退票
银行渠道为工行时为空		0
back_reasonstring(100)否支付失败或退票原因描述
银行渠道为工行时为空		　

响应示例

  1. {
  2.     "bedl_ent_single_transfer_query_response": {
  3.         "request_id": "openapi_df2f3932cd88441781b167e76039f642",
  4.         "code": 10000,
  5.         "data": {
  6.             "channel": "02",
  7.             "node_id": "00025633",
  8.             "third_voucher_no": "20250601151617000001",
  9.             "ym_trade_no": "AT111300000000000001",
  10.             "channel_trade_no": "1111111111",
  11.             "custom_no": "20250601151617000001",
  12.             "ccy_code": "RMB",
  13.             "store_id": "S0001",
  14.             "out_acct_no": "15000100714429",
  15.             "out_acct_name": "科技有限公司",
  16.             "in_acct_no": "15000100714430",
  17.             "in_acct_name": "科技有限公司",
  18.             "in_acct_bank_name": null,
  19.             "trans_amount": 1000,
  20.             "status": 1,
  21.             "status_desc": "交易成功",
  22.             "union_flag": "1",
  23.             "fee": 0,
  24.             "post_fee": null,
  25.             "host_flow_no": "111111111111111",
  26.             "host_tx_date": "2025-06-01"
  27.             "is_back": 0,
  28.             "back_reason": null,
  29.         },
  30.         "success": true
  31.     },
  32.     "sign": "cSkhGHI413Ob77ixs4HQr4MKah+tLGJVnPuOm7lxj5C+ZK768w9ykhRZs0OE7zc9DVEJjDCHSZxD7hH/bSefnarx8scKnevS9LvQ4ksGrtWkbljnP0wbgtxWPoq8pYO2F6PNhQTXuYarQC++VJFT3l/vsC7tbNxvtP74orgwi68C8jxIhrBlF5H2FBsproWrlCTNo0E75kY8CLG+PwcqGdO3RS3BlnWDLbyq8mFRZ1OpQyOEjMr2CCzlFiDSQSqFp/jsojxULbsYgN2eKzo3zndGlxRKtIT2vzOcAQTgEAbQB7E2TlLXvNvstS1iwIEoN0aoQp2JxPsK1F5vwZ3hGg=="
  33. }