5.3.1 银行转账下单接口

请求参数

Body 参数application/json

appId

string

应用APPID

必需

商户应用APPID

subSn

string | null

子商户编码

可选

非必传项，目前仅代理商/服务商可传，普通商户和平台商户请勿传入

timestamp

string

时间戳

必需

请求时间戳单位秒，要求timestamp与当前时间间隔在60秒以内

requestId

string

请求id

必需

请求唯一标识，无其他意义，必须每一次请求不允许重复，用于定位问题

signType

string

签名方式

必需

固定值：RSA2

bizContent

object

请求参数

必需

由于工具限制，该字段必须转为JSON格式字符串，请注意

payType

string

支付类型

必需

BANKTRANSFER=银行大额转账

paySubType

string

支付方式

必需

PC :电脑浏览器，目前支持PC支付

providerCode

null

服务商编码

可选

不传随机路由

channelCode

null

通道编码

可选

不传随机路由

mchChannelCode

null

子通道code

可选

不传随机路由，平台商调用必传该参数否则会出现资金问题

mchOrderNo

string

商户订单号

必需

规则英文字符,数字,_

amount

string

订单金额

必需

单位元

clientIp

string

买家ip

必需

目前仅支持ipv4

subject

string

商品标题

必需

不能超过64个字符

description

string | null

商品描述

可选

extra

object | null

通道额外参数

可选

notifyUrl

string | null

异步通知

可选

支付结果异步通知地址

redirectUrl

string | null

同步跳转地址

可选

同步跳转地址

expiredTime

integer

订单过期时间

可选

不传默认30分钟单位秒

默认值:

360

示例值:

360

fundProcessType

string

分账类型

可选

0或空=无分账，1=实时分账，2=延时分账，3=商户预设默认分账

默认值:

null

示例值:

null

acctInfos

array [object {3}] | null

分账接收方列表

可选

非空或0必传

sign

string

签名

必需

参照签名方法

示例

{
  "appId": "string",
  "subSn": "string",
  "timestamp": "string",
  "requestId": "string",
  "signType": "string",
  "bizContent": {
    "payType": "string",
    "paySubType": "string",
    "providerCode": null,
    "channelCode": null,
    "mchChannelCode": null,
    "mchOrderNo": "string",
    "amount": "string",
    "clientIp": "string",
    "subject": "string",
    "description": "string",
    "extra": {
      "checkType": 0
    },
    "notifyUrl": "string",
    "redirectUrl": "string",
    "expiredTime": 360,
    "fundProcessType": "null",
    "acctInfos": [
      {
        "amount": "string",
        "accountNo": "string",
        "description": "string"
      }
    ]
  },
  "sign": "string"
}

返回响应

🟢200成功

application/json

Body

code

integer

请求状态

必需

返回200=成功，其他状态均为失败

data

object

返回数据体

必需

mchOrderNo

string

商户订单号

必需

payOrderNo

string

平台订单号

必需

channelOrderNo

string

渠道订单号

可选

第三方渠道订单号

instOrderNo

string

支付机构订单号

可选

微信支付宝等平台订单号

payDataType

string

支付数据类型

可选

pay_url-支付链接，data-数据体，none-空支付参数

payInfo

string

支付数据

可选

银行转账支付账号数据，json格式字符串，remitRemarkCode=附言，receiveName=收款方名称，receiveAccountNo=收款方账号，accountName=收款方开户行，areaInfo=省市／地区

state

string

订单状态

必需

订单状态，1=初始化，2=支付中，3=支付成功，4=已撤销，5=订单关闭 6=订单关闭中 7=支付失败

amount

string

订单金额

必需

单位元

payAmount

string

实际支付金额

可选

单位元

payType

string

支付类型

必需

WECHAT: 微信 ALIPAY: 支付宝 UNION_APY: 云闪付 DIGITAL: 数字人民币 QUICK：快捷支付

paySubType

string

支付方式

必需

NATIVE :扫码支付； SCAN : 反扫支付； JSAPI :微信JSAPI、支付宝JSAPI支付、银联JSAPI支付； SIMPLE :简易支付； MINI_APP :微信小程序支付、支付宝小程序支付； H5 :h5 支付； APP :APP 支付； PC :支付宝PC支付

sceneType

integer

场景类型

可选

1 线下 2 线上不传默认线下

providerCode

string

服务商编码

可选

channelCode

string

通道编码

可选

subChannelId

string

子通道id

可选

feeAmount

string

平台扣手续费

可选

feeRate

string

平台扣手续费率

可选

channelFeeAmount

string

通道扣手续费

可选

channelFeeRate

string

通道扣手续费率

可选

settlementAmount

string

实际记账金额

可选

即 amount-feeAmount-channelFeeAmount

subject

string

商品标题

可选

description

string

商品描述

可选

successTime

integer

支付成功时间

可选

单位毫秒

msg

string

返回信息

可选

appId

string

应用APPID

必需

string

商户编码

可选

sign

string

签名

必需

timestamp

string

时间戳

必需

signType

string

签名方式目前仅支持RSA2

必需

示例

{
  "code": 0,
  "data": {
    "mchOrderNo": "string",
    "payOrderNo": "string",
    "channelOrderNo": "string",
    "instOrderNo": "string",
    "payDataType": "string",
    "payInfo": "string",
    "state": "string",
    "amount": "string",
    "payAmount": "string",
    "payType": "string",
    "paySubType": "string",
    "sceneType": 0,
    "providerCode": "string",
    "channelCode": "string",
    "subChannelId": "string",
    "feeAmount": "string",
    "feeRate": "string",
    "channelFeeAmount": "string",
    "channelFeeRate": "string",
    "settlementAmount": "string",
    "subject": "string",
    "description": "string",
    "successTime": 0
  },
  "msg": "string",
  "appId": "string",
  "sn": "string",
  "sign": "string",
  "timestamp": "string",
  "signType": "string"
}

请求参数

示例代码

返回响应