接口说明

调用方：商户接入系统

接收方：银账通系统

功能：实时接收订单上传交易明细，接口返回成功表示订单已成功接收，订单处理成功将通过订单上传结果通知接口进行异步通知。

请求地址及接口名

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

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

接口名(method)：funds.bill.upload

公共请求参数

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

业务请求参数

名称类型必须描述示例值
trade_typestring(8)是交易类型：1-支付，2-退款1
goods_detailstring(6000)否商品信息详见goods_detail说明
node_idstring(8)是机构号100001
order_amountinteger是订单金额，单位分199
order_idstring(32)是订单交易流水号100010001
order_timestring(16)是订单交易时间20240301131800
org_order_idstring(32)否原订单交易流水号100010000
pay_merchant_idstring(32)否第三方支付渠道商户号1302329392
pay_typestring(8)否支付渠道：502-支付宝，503-微信，512-银联云闪付502
store_idstring(16)是门店id20008221
trade_nostring(32)否支付平台订单号2019112011001004330000121536
user_idstring(8)否操作员标识01
fee_amountinteger否交易手续费，单位分1
split_rule_sourcestring(8)否分账规则来源：1-接口，不传默认为空，表示控台1
split_refund_seqstring(64)否分账退回流水号
仅浙商通道退款订单上传时必填		1001XP2025010110000001_S01_R01

goods_detail 商品信息 (JSONArray)

名称类型必须描述示例值
goods_idstring(32)是商品的编号apple-01
goods_namestring(256)是商品名称ipad
quantityinteger是商品数量1
priceinteger是商品单价，单位为分200000
real_priceinteger是商品实际单价，单位为分199999
goods_categorystring(24)否商品类目34543238
bodystring(1024)否商品描述信息特价手机
goods_fee_amountinteger否商品金额手续费，单位为分1

范例：

  1. [
  2.     {
  3.         "goods_name": "ipad",
  4.         "quantity": 1,
  5.         "price": 200000,
  6.         "real_price": 199999,
  7.         "goods_id": "apple-01",
  8.         "goods_category": "34543238",
  9.         "body": "特价手机",
  10.         "goods_fee_amount": 1
  11.     },
  12.     {
  13.         "goods_name": "ipad2",
  14.         "quantity": 1,
  15.         "price": 200000,
  16.         "real_price": 199999,
  17.         "goods_id": "apple-02",
  18.         "goods_category": "34543239",
  19.         "body": "特价手机2",
  20.         "goods_fee_amount": 1
  21.     }
  22. ]

请求示例

  1. {
  2.     "charset": "utf-8",
  3.     "biz_content": "{\"fee_amount\":1,\"goods_detail\":\"[{\\\"goods_id\\\":\\\"apple-01\\\",\\\"goods_name\\\":\\\"ipad\\\",\\\"quantity\\\":1,\\\"price\\\":200000,\\\"goods_id\\\":\\\"apple-01\\\",\\\"goods_category\\\":\\\"34543238\\\",\\\"real_price\\\":199999,\\\"body\\\":\\\"特价手机\\\"，\\\"goods_fee_amount\\\":1},{\\\"goods_name\\\":\\\"ipad2\\\",\\\"quantity\\\":1,\\\"price\\\":200000,\\\"goods_id\\\":\\\"apple-02\\\",\\\"goods_category\\\":\\\"34543239\\\",\\\"real_price\\\":199999,\\\"body\\\":\\\"特价手机2\\\",\\\"goods_fee_amount\\\":1}]\",\"merchant_id\":\"1000000000826\",\"node_id\":\"100001\",\"order_amount\":199,\"order_id\":\"100010001\",\"order_time\":\"20240301131800\",\"org_order_id\":\"100010000\",\"pay_merchant_id\":\"1302329392\",\"pay_type\":\"502\",\"remark\":\"备注\",\"store_id\":\"20008221\",\"trade_no\":\"2019112011001004330000121536\",\"trade_type\":\"1\",\"user_id\":\"01\",\"split_rule_source\":\"1\"}",
  4.     "method": "bkfunds.order.upload",
  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(64)是每次请求唯一id4e770f101c9a4191bfd4609d26c6e0bd
codestring(8)是返回码40002
msgstring(1024)是返回信息非法的参数
sub_codestring(16)是请求失败返回的子错误码isv.invalid-app-key
sub_msgstring(1024)是请求失败返回的子错误信息无效的app_id参数
signstring(512)是响应参数的签名串XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

业务响应参数

名称类型必须描述示例值
codestring(8)否响应码10000
datastring(1024)否交易数据本接口返回空
msgstring(1024)否错误描述success
successboolean否是否成功true

响应示例

  1. {
  2.     "bkfunds_order_upload_response": {
  3.         "request_id": "4b8e7ca9cbcb448491df2f0120e49b9d",
  4.         "code": "10000",
  5.         "msg": "success",
  6.         "success": true,
  7.         "data": ""
  8.     },
  9.     "sign": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
  10. }

错误响应示例

  1. {
  2.     "error_response": {
  3.         "request_id": "0d27836fcac345729176359388aeeb74",
  4.         "code": "40004",
  5.         "msg": "业务处理失败",
  6.         "sub_code": "isv.name-error",
  7.         "sub_msg": "姓名错误"
  8.     },
  9.     "sign": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
  10. }