字段

字段类型

必填

字段名称

说明

appId

String

是

应用号

spAppId

String

否

服务商应用号

fileType

String

是

文件类型

上送：3：证件材料

md5

String

是

文件的MD5值

sign

String

是

签名

将spAppId+appId+fileType+md5+timestamp值拼接后使用SM3withSM2进行签名后base64编码生成的字符串

file

file

是

文件流

文件大小控制在2M以内

字段

字段类型

字段长度

必填

字段名称

说明

fileId

String

40

否

文件标识

00000-交易成功，返回，有效期30分钟

respCode

String

5

是

业务返回码

respMsg

String

200

是

返回说明

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

是

商户请求流水号

signNum

String

是

商户会员编号

enterpriseName

String

是

企业名称

unifiedSocialCredit

String

是

统一社会信用

legalPersonName

String

是

法人姓名

legalPersonCerNum

String

否

法人证件号码

明文上送

legalPersonPhone

String

否

法人手机号码

字段

字段类型

必填

字段名称

说明

respTraceNum

String

否

响应流水号

respCode

String

是

返回码

respMsg

String

否

失败原因

enterpriseBene
ficiaryList

JSONArray

否

企业最终受
益人信息数组

查询成功则返回

字段

字段类型

必填

字段名称

说明

beneficiaryName

String

是

受益所有人名称

incomeWay

是

受益人受益方
式

A01：直接或间接控股25%（含）以上

A02：通过人事、财务等其他方式对公司进行控制

A03：高级管理人员

A04：法人或公司负责人

A05：其他

shareholdingRatio

是

最终受益人持股比
例

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

是

商户请求流水号

商户系统内保持唯一，定义长度为50位

signNum

String

是

商户会员编号

若平台会员编号，上送#yunBizUserId_B2C#

memberRole

String

否

会员角色

（1）未注册，必须上送角色

（2）已注册，无需上送，上送则需要与设置的角色一致

notifyUrl

String

是

企业会员审核结果通知地址

如下情况，企业会员信息实名成功/失败均发送通知：

（1）接口自动完成实名

（2）运营平台人工审核后

enterpriseBaseInfo

JSONObject

是

企业基本信息

bankAcctDetail

JSONObject

是

银行账户信息

详细

enterpriseDetail

JSONObject

否

企业详情信息

bankAcctReqInfo

JSONObject

否

银行开户请求信息

仅银行管理或银行托管，可上送

详情

字段

字段类型

必填

字段名称

说明

enterpriseName

String

是

企业名称

如有括号，用中文格式（）

enterpriseNature

String

否

企业性质：

1-企业

2-个体工商户

3-事业单位

不填，则默认“企业”

注：企业名称含“公司”，不支持上送“个体工商户”

addressCode

String

是

地区码（企业注册地所在省市区）

见数据字段

enterpriseAdress

String

是

企业注册地地址

unifiedSocialCredit

String

是

统一社会信用

busLicenseValidate

String

否

营业证件有效期

针对华通银行（企业性质），必填

busLicenseLicEffDate

String

否

营业执照生效日期

针对华通银行（企业性质），必填

legalPersonName

String

是

法人姓名

legalPersonCerType

String

是

法人证件类型

详细

legalPersonCerNum

String

是

法人证件号码

SM4加密，详细

idValidateStart

String

否

法人证件有效开始日期

格式：9999-12-31

华通银行，必填

新网银行，必填

idValidateEnd

String

否

法人证件有效截止日期

若长期有效上送“9999-12-31”

格式：9999-12-31

若长期有效上送“9999-12-31”

华通银行，必填

新网银行，必填

legalPersonPhone

String

是

法人手机号码

legpCerFrontFileId

String

否

法人身份证（肖像面）token

通过【文件上传下载接口】上传文件图片后获取的fileId，有效期30分钟，图片不超过2M

法人身份证证件类型：肖像面和国徽面必须同时上传。

法人非身份证证件类型：仅上传“法人身份证（肖像面）token”即可。

华通银行，必填

新网银行，必填

legpCerBackFileId

String

否

法人身份证（国徽面）token

unifiedSocialCreditFileId

String

否

统一信用证token

字段

类型

必填

字段名称

说明

bankCardNo

String

是

银行卡号

SM4加密，详细。

bankAccountName

String

是

银行户名

bankName

String

是

银行名称

bindTime

String

是

绑定时间

yyyy-MM-dd HH:mm:ss

cardType

String

是

银行卡类型

详细

bindStatus

String

是

绑定状态

详细

bankReservePhone

String

否

银行预留手机号码

bindType

String

否

绑卡方式

详细

对公，为空

acctAttr

String

是

银行卡/账户属性

0：对私

1：对公

openBankBranchName

String

否

开户行支行名称

如：“中国工商银行股份有限公司北京樱桃园支行”

payBankNumber

String

否

支付行号

12位数字

openBankProvince

String

否

开户行所在省

开户行所在市必须同时上送

根据中国省市表的“省份”内容填写。详情

openBankCity

String

否

开户行所在市

开户行所在省必须同时上送

根据中国省市表的“城市”内容填写。详情

isSpecifyAcct

String

是

是否为支付账户指定出入金银行账户

1. 是；
2. 否

字段

字段类型

必填

字段名称

说明

openBankNo

String

是

开户银行编码

校验与配置的开户银行一致

新网银行：1024

字段

字段类型

必填

字段名称

说明

enterpriseScale

String

否

企业规模

针对华通银行（企业性质），必填

enterpriseType

String

否

企业类型

针对华通银行（企业性质），必填

economicNature

String

否

企业经济性质

针对华通银行（企业性质），必填

country

String

否

国籍

针对华通银行，必填

regCapital

String

否

企业注册资本

单位：元

针对华通银行（企业性质），必填

occupation

String

否

行业

针对华通银行，必填（个体工商户，上送职业枚举值）

新网银行，必填

businessBeginDate

String

否

公司经营开始时间

格式：yyyy-MM-dd

针对华通银行（企业性质），必填

businessEndDate

String

否

公司经营结束日期

格式：yyyy-MM-dd

针对华通银行（企业性质），必填

contactMobile

String

否

企业联系人手机号

针对华通银行（企业性质），必填

linkAddresscode

String

否

经营地址省市区/企业联系地址所在省市区，地区码

针对华通银行（企业性质），必填

enterpriseAddress

String

否

经营详细地址/企业联系地址

针对华通银行（企业性质），必填

新网银行，必填

businessScope

String

否

经营范围

针对华通银行（企业性质），不上送

openLicenseCode

String

否

开户许可证核准号或基本存款账户编号

针对华通银行（企业性质），不上送

openLicenseToken

String

否

开户许可证文件

针对华通银行（企业性质），不上送

legalAuthFileId

String

否

企业法人授
权书开放平台
文件id

经办人与法人不一致，必填

shareholderInfo

JSONObect

否

控股股东/实际控制人

针对华通银行（企业性质），必填

新网银行，必填

beneficiaryInfo

JSONObect

否

受益所有人信息

针对华通银行（企业性质），必填

新网银行，必填

contactInfo

JSONObect

否

企业联系人信息

新网银行，必填

字段

字段类型

必填

字段名称

说明

shareholderName

String

否

控股股东/实际控制人名称

shareholderCertType

String

否

控股股东/实际控制人证件类型

shareholderCertNo

String

否

控股股东/实际控制人证件号

无需加密

shareholderCertBeginDate

String

否

控股股东/实际控制人证件开始日期

YYYY-MM-DD

shareholderCertEndDate

String

否

控股股东/实际控制人证件截止日期

长期：9999-12-31

shareholderPhone

String

否

股东或实际控制人电话

shareholdingRatio

String

否

控投股东持
股比例，可
选（如果是50
%，请输入0.5）

shareholderCertFrontToken

String

否

控股人身份证（肖像面）token

shareholderCertBackToken

String

否

控股人身份证（国徽面）token

字段

字段类型

必填

字段名称

说明

beneficiaryName

String

否

受益所有人名称

beneficiaryAddress

String

否

受益所有人地址

beneficiaryPhone

String

否

受益所有人电话

beneficiaryIdType

String

否

受益所有人证件类型

beneficiaryIdNo

String

否

受益所有人证件号码

无需加密，明文上送

beneficiaryIdEffDate

String

否

受益所有人证件开始日期

beneficiaryIdOffDate

String

否

受益所有人证件到期日期

incomeWay

String

否

受益人受益方
式

A01：直接或间接控股25%（含）以上

A02：通过人事、财务等其他方式对公司进行控制

A03：高级管理人员

A04：法人或公司负责人

A05：其他

shareholdingRatio

String

否

最终受益人持股比
例

可选（如果是50
%，请输入0.5）

beneficiaryConfirmId

String

否

企业最终受
益人认定文
件开放平台文件id

beneficiaryCertFrontToken

String

否

企业受益人身份证（肖像面）token

beneficiaryCertBackToken

String

否

企业受益人身份证（国徽面）token

字段

字段类型

必填

字段名称

说明

contactName

String

否

企业联系
人姓名

contactPhone

String

否

企业联系
人电话

contactCertType

String

否

企业联系人证件类
型

contactCertNum

String

否

企业联系人证件号
码

明文上送

contactCertBeginDate

String

否

联系人证件起始日
期

格式：9999-12-31

contactCertEndDate

String

否

联系人证件截止日
期

长期则上送：9999-12-31

contactCertFrontId

String

否

企业联系人身份证（肖像面）token

contactCertFrontId

String

否

企业联系人身份证（国徽面）token

contactAuthFileId

String

否

企业联系人
授权书开放平
台文件id

联系人和法人不一致，必填

字段

字段类型

字段长度

必填

字段名称

说明

respTraceNum

String

否

响应流水号

业务正常处理，则返回

signNum

String

否

商户会员编号

bankAcctResInfo

JSONObect

否

银行开户响应信息

新网银行，不返回

respCode

String

是

业务返回码

定义银行返回“审核中”或“失败”的返回码

respMsg

String

是

失败原因

银行返回“审核中”，则返回“银行开户已受理，处理中”；

银行返回“失败”，则透传银行失败原因

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

是

商户请求流水号

商户系统内保持唯一，定义长度为50位

signNum

String

60

是

商户会员编号

auditResult

String

1

是

审核结果：

2：审核成功。

3：审核失败。

4: 审核中

auditTime

String

20

是

审核时间

格式：20240226170408

remark

String

200

否

备注

auditResultMsg

String

200

否

失败原因

“待联系人短信认证”

“待法人短信认证”

“银行开户成功”

失败，透传银行开户失败原因

字段

字段类型

必填

字段名称

说明

reqTraceNum

String

是

请求流水号

verifyType

String

是

验证类型

OPEN_ACCT：开户

BIND_CARD：绑卡

oriRespTraceNum

String

是

原业务响应流水号

【企业会员实名开户】接口的响应流水号

【银行用户信息绑卡】接口响应流水号

amount

Long

是

打款金额

单位：分

字段

字段类型

必填

字段名称

说明

respTraceNum

String

否

响应流水号

respMsg

String

否

失败原因

verifyResult

否

小额打款验证结果

1：验证成功:

2：验证失败

bindResult

否

绑卡结果

1：绑卡成功

2：绑卡失败

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

是

商户请求流水号

phone

String

否

手机号

BINDING_CARD：绑卡，必填

smsType

String

是

短信类型

OPEN_ACCT_SMS_CONT
ACT_AUTH：企业开户联系人认证短信

OPEN_ACCT_SMS_LEGAL_AUTH：企业开户法人认证短信

BINDING_CARD：绑卡

oriRespTraceNum

String

否

原开户响应流水号

当短信类型为以下枚举时，必填OPEN_ACCT_SMS_CONTACT_AUTH、OPEN_ACCT_SMS_LEGAL_AUTH

说明：【企业会员实名开户】接口响应流水号

cardNum

否

绑定卡号

当短信类型为以下枚举时必传
BINDING_CARD

electAcctNo

否

电子
台账编号

当短信类型为以下枚举时必传
BINDING_CARD

字段

字段类型

必填

字段名称

说明

respTraceNum

String

否

响应流水号

respCode

String

是

业务码

发送验证码成功/失败，定义“返回码”

respMsg

String

否

失败原因

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

是

商户请求流水号

verifyType

String

否

验证类型

OPEN_ACCT_SMS_CONTACT_AUTH：联系人确认

OPEN_ACCT_SMS_LEGAL_AUTH：法人确认

oriRespTraceNum

是

开户响应流水号

【企业实名开户】接口响应流水号

verifyCode

String

是

短信验证码

字段

字段类型

必填

字段名称

说明

respTraceNum

String

否

响应流水号

respCode

String

是

业务码

返回校验处理成功、失败的业务码

respMsg

String

否

失败原因

字段

字段类型

字段长度

必填

字段名称

说明

oriRespTraceNum

String

是

开户响应流水号

【企业实名开户】接口响应流水号

字段

字段类型

必填

字段名称

说明

respTraceNum

String

否

响应流水号

openAcctStatus

String

否

开户状态

SUCCESS：成功

FAIL：失败

PROCESSED：处理中（审核中）

legpVerifyStatus

否

企业开户-法人短验开户状态

(企业短验开户模式)

初始化：INIT

成功：SUCCESS

失败：FAIL

待短信认证：WAITSMSCONFIRM

contactVerifyStatus

否

企业开户-联系人短验开户状态

(企业短验开户模式)

初始化：INIT

成功：SUCCESS

失败：FAIL

待短信认证：WAITSMSCONFIRM

smallPaymentStatus

否

企业开户-小
额打款状态

需要小额打款验证时有效，
WAIT：待小额打款验证 SU
CCESS：小额打款验证成功
FAIL：小额打款验证失败

authStatus

企业开户-新
网审核状态

WAIT：待新网审核 SUCCE
SS：新网审核成功 FAI
L：新网审核失败

errorMsg

否

开户失败原因

acctList

否

电子台账数组

字段

字段类型

必填

字段名称

说明

acctNo

String

是

电子
台账编号

acctType

String

是

电子
台账类型

O_PWD：免密余额账簿 PEN
DING_SETTLE：待结算账簿

字段

字段类型

必填

字段名称

说明

reqTraceNum

String

是

请求流水号

signNum

String

是

商户会员编号

支持平台类账户查询，上送#yunBizUserId_B2C#

subAcctNo

String

否

银行子账号

银行账户类型=14，必填

acctAttr

String

是

银行账户类型

针对中信银行，可上送如下：

（1）银行为商户交易资金账户开立的公共登记簿标识、发起方输入标识进行查询：

00：公共计息收费登记薄
12：自有资金登记薄
13：担保登记薄
17：待结算手续费登记簿

（2）用户登记簿标识：

14：子商户/用户登记薄

（3）平台剩余透支额度标识

RO_平台剩余透支额度

针对华通银行，必填，仅支持上送“14”

新网银行支持上送14

字段

字段类型

必填

字段名称

说明

respTraceNum

String

否

响应流水号

respCode

String

是

业务码

00000：代表成功

66666、66667：处理中，即当前的请求已受理，需要继续调用关联的确认类接口，或通过发起订单查询、等待异步通知，来获取处理状态。

其他返回码：均代表失败

respMsg

String

否

失败原因

signNum

String

是

商户会员编号

avlBalance

Long

否

可用余额

单位：分

说明：中信银行、华通银行返回“可用余额”

新网银行返回

withdrawBalance

Long

否

可提现余额

单位：分

说明：中信银行返回

新网银行返回

balance

Long

否

总余额

单位：分

说明：华通银行返回

说明：华通银行总余额=冻结金额+可用余额

新网银行返回

frozenAmount

Long

否

冻结金额（不可用）

单位：分

说明：华通银行返回

新网银行返回

transitAmount

否

在途金额

单位：分

新网银行返回

frozenTransitAmt

否

冻结在途金额

单位：分

新网银行返回

frozenWithdrawAmt

否

冻结可提现金额

单位：分

新网银行返回

splsOverBalance

Long

否

平台剩余透支金额

单位：分

仅上送“RO_平台剩余透支额度”返回

说明：中信银行返回

字段

字段类型

必填

字段名称

说明

reqTraceNum

String

是

请求流水号

signNum

String

是

商户会员编号

subAcctNo

String

是

银行子账号

dateStart

String

是

查询日期（日期格式YYYYMMDD）

开始日期和结束日期，时间间隔不大于3天；

中信银行，开始日期和结算日期必须相同

dateEnd

String

是

结束日期，YYYYMMDD

qryTradeType

String

否

交易类型

新网银行，无需上送

returnRows

String

否

查询条数

中信银行固定50条

华通银行无需上送

page

String

否

页数

第一页查询：上送1，默认返回50条

华通银行无需上送

字段

字段类型

必填

字段名称

取值

respTraceNum

String

否

响应流水号

受理成功，则返回

respCode

String

是

返回码

00000：受理成功

respMsg

String

否

返回信息

signNum

String

是

商户会员编号

subAcctNo

String

是

银行子账号

totalPage

String

否

总页数

华通银行不返回

totalNum

String

否

记录总行数

查询成功，则返回

subAcctDetail

List

否

银行子账户收支明细

查询成功，则返回

详情

名称

说明

类型

取值

acctName

用户名称

String

chnlTradeCode

银行交易流水号

String

reqTraceNum

业务订单号

String

reqSubTraceNum

业务子订单号

String

tradeDate

交易日期

String

yyyyMMdd

tradeTime

交易时间

String

HHmmss

tradeType

交易类型

String

sysOrderNo

系统流水号

String

银行返回

fundDirection

资金方向

String

D:账户出金

C:账户入金

tradeAmount

交易金额

String

单位：分

oppAcctNo

对手方账号

String

入金返回

oppAcctName

对手方户名

String

入金返回

beforeBalance

操作前余额

String

单位：分

afterBalance

操作后余额

String

单位：分

summary

摘要描述

String

透传银行摘要

purpose

用途

String

用途

remark

备注

String

备注

postscript

附言

String

附言

tradeStatus

交易状态

String

正常:N,

充正:R,

被充正:X

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

是

商户请求流水号

商户系统内保持唯一，定义长度为50位

signNum

String

是

商户会员编号

subAcctNo

String

是

银行子账号

bankAcctDetail

JSONObject

是

银行账户信息

详情，复用企业实名开户接口的银行账户对象

bankAcctExtInfo

JSONObject

否

银行绑卡申请（其他）信息

详情，

字段

字段类型

必填

字段名称

说明

acctAttr

String

否

账户类型

对私（银行账户名称默认为法人姓名）

对公（银行账户名称默认为企业名称）

企业性质=企业/事业单位，默认1-对公，不支持上送0-对私；

企业性质=个体工商户，支持上送0-对私/1-对公，不填默认1-对公；

acctNum

String

是

账号

账户类型=1-对公，企业对公账户，支持数字和“-”字符

账户类型=0-对私，则上送对私账户（借记卡）

SM4加密，详细

bankReservePhone

String

否

银行预留手机

账户类型=0-对私，则必填

openBankNo

String

否

银行代码

对公：根据基础数据，上送“银行代码”字段,必填

对私：无需上送，系统自动根据卡BIN识别银行。

openBankBranchName

String

否

开户行支行名称

如：“中国工商银行股份有限公司北京樱桃园支行”

账户类型=1-对公，则必填

payBankNumber

String

否

支付行号，12位数字

账户类型=1-对公，则必填

openBankProvince

String

是

开户行所在省

开户行所在省

开户行所在市必须同时上送

根据中国省市表的“省份”内容填写。

openBankCity

String

是

开户行所在市

开户行所在市

开户行所在省必须同时上送

根据中国省市表的“城市”内容填写。

verifyCode

String

否

短信验证码

新网，必填

字段

字段类型

字段长度

必填

字段名称

说明

respTraceNum

String

否

响应流水号

业务正常处理，则返回

respCode

String

是

业务返回码

00000：代表成功

66666、66667：处理中，即当前的请求已受理，需要继续调用关联的确认类接口，或通过发起订单查询、等待异步通知，来获取处理状态。

其他返回码：均代表失败

respMsg

String

是

失败原因

信息类型

返回数据说明

1-基本信息

返回个人会员、企业会员基本信息

2-银行账户信息

返回个人会员（绑定状态=已绑定）的银行账户列表

返回企业会员（【企业会员实名开户】接口）设置的银行账户信息

3-协议信息

返回该会员签订的收款协议、账户提现协议、分账协议、授权委托书（所有签约状态的协议）

4-影印件ocr核对信息

返回影印件识别比对结果

5-绑定手机信息

返回会员绑定的手机号

6-支付账户信息

返回会员支付账户信息

7-支付账户审核结果详情

返回会员支付账户审核结果详情

8-银行子账户信息

返回银行子账户信息（子账户、绑卡信息）

9-待结算户信息

返回待结算户信息

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

是

请求流水号

signNum

String

60

是

商户会员编号

平台则上送“#yunBizUserId_B2C”

infoType

String

1

是

查询信息类型

1-基本信息

2-银行账户信息

3-协议信息

4-影印件ocr核对信息

5-绑定手机号信息

6-支付账户信息

7-支付账户审核结果详情

8-银行子账户信息

9-待结算户信息

字段

字段类型

字段长度

必填

字段名称

说明

respTraceNum

String

40

否

响应流水号

业务正常处理，则返回

respCode

String

5

是

业务码

respMsg

String

200

否

失败原因

signNum

String

60

否

商户会员编号

memberBasicInfo

JSONObject

否

会员基本信息

个人会员基本信息

企业会员基本信息

acctInfo

JSONArray

否

银行账户信息

支持返回多个银行账户信息

详细

agreementArray

JSONArray

否

协议信息

详细

ocrResultJson

JSONObject

否

影印件OCR核对结果

详细

bindPhoneJson

JSONObject

否

绑定手机号信息

详细

payAcctOpenJson

JSONArray

否

支付账户开户信息

详细

payAcctAuditJson

JSONObject

否

支付账户审核结果详情

详细

bankSubAcctInfo

JSONArray

否

银行子账户信息

settleAcctInfo

JSONObject

否

待结算户信息

字段

字段类型

必填

字段名

说明

openBankNo

String

是

开户银行编码

新网银行：

subAcctNo

String

是

银行子账号

开户成功，则返回

subAcctStatus

String

是

银行子账户状态

未激活

正常

已注销

acctType

String

否

银行子账户类型

01：普通账户

02：佣金账户

03：待结算户

04：免密余额户

openAcctTime

String

是

开户时间

开户成功，则返回

格式：202404251647

cardList

List

否

银行绑卡信息

字段

字段类型

必填

字段名称

说明

cardNo

String

是

银行卡号

明文返回

bindingAcctBa

nkCode

否

绑定账户开户行行号

新网银行返回

bindingAcctBa

nkName

否

绑定账户开户行行名

新网银行返回

bindingAcctNa

me

否

绑定账户名称

新网银行返回

bindingAcctTy

pe

否

绑定卡类型

借记卡: DEBIT,

贷记卡: CREDIT,

对公账户: PUBLIC

绑定卡类型

借记卡: DEBIT,

贷记卡: CREDIT,

对公账户: PUBLIC

新网银行返回

bindState

String

是

卡状态

1：已绑定

0：未绑定

2: 已解绑

3：已冻结（账号暂不可用）

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

是

请求流水号

signNum

String

是

商户会员编号

#yunBizUserId_B2C#

subAcctNo

String

是

银行子账号

opType

String

是

操作类型

授权申请SETTLE_AUTH_AP
PLY  

授权确认SETTLE_AUTH_CONFIRM

verifyCode

String

否

短信验证码

SETTLE_AUTH_CONFIRM时
填写

orderMaxAmount

Long

否

授权单笔最大
金额

单位:分，opt
_type=SETTLE_AUTH_AP
PLY时必填

dayMaxAmount

Long

否

授权单日最大
金额

单位:分，opt
_type=SETTLE_AUTH_AP
PLY时必填

beginDate

String

否

授权
开始日期

yyyyMMdd，opt_type=SE
TTLE_AUTH_APPLY时必填

endDate

String

否

授权
截至日期

yyyyMMdd，opt_type=SE
TTLE_AUTH_APPLY时必填

remark

String

否

备注

备注

authType

String

是

授权类型

一次性授权：1
 长期性授权：2

字段

字段类型

字段长度

必填

字段名称

respTraceNum

String

否

响应流水号

respCode

String

是

业务码

respMsg

String

否

失败原因

authCode

String

否

授权ID

业务场景

商户系统

云商通

1笔业务订单全部支付

业务订单号

商户订单号（reqTraceNum）

1笔业务订单多次部分支付

业务订单号

商户订单号1（reqTraceNum）

商户订单号2（reqTraceNum）

商户订单号3（reqTraceNum）

多笔业务订单合并支付（多收款人）

业务订单号1

业务订单号2

业务订单号3

。。。

商户订单号（reqTraceNum）

字段

字段类型

字段长度

必填

字段名称

说明

signNum

String

60

否

商户会员编号-付款人

商户系统用户唯一标识

银行卡协议支付：付款会员需先注册

非银行卡协议支付：付款会员无需注册

receiverSignNum

String

60

否

商户会员编号-收款人

商户系统用户唯一标识

支持个人会员、企业会员，不支持平台会员（平台会员不设置角色），若“平台会员”固定上“#yunBizUserId_B2C#”

platAcctType

String

2

否

平台账户类型

“receiverSignNum”为平台会员时，必填；

09：应用储值卡账户（非“账后结算”资金管理模式）

10：储值卡待结算户（“账户结算”资金管理模式）

reqTraceNum

String

50

是

商户订单号

orderAmount

Long

20

是

订单金额

单位：分

订单金额=支付金额+营销金额

payAmount

Long

20

否

支付金额

单位：分

渠道实际需支付金额

不上送时，则“营销金额”必送，即：订单金额=营销金额；

promotionAmount

Long

20

否

营销金额

单位：分

平台承担的营销金额

couponAmount

Long

20

否

平台抽佣金额

单位：分

仅上送“收款会员编号”时有效；

payMode

JSONObject

256

否

支付模式

详见支付模式字典

详情

注“支付金额”为空或0时，可不送

sepDetail

JSONArray

否

分账规则

分账规则列表

详细

reqsUrl

String

256

否

前台通知地址

respUrl

String

256

是

后台通知地址

orderValidTime

String

20

否

订单过期时间

goodsName

String

50

否

商品名称

如下支付模式必填：

1.快捷支付

2.H5收银台

3.微信小程序收银台

4.支付宝小程序收银台

goodsDesc

String

256

否

商品描述

summary

String

100

否

摘要

extendParams

String

200

否

扩展参数

字段

字段类型

字段长度

必填

字段名称

说明

result

String

1

否

订单状态

订单成功时会发订单结果通知商户。

详情

respTraceNum

String

40

是

通联订单号

reqTraceNum

String

50

是

商户订单号

extendParams

String

200

否

扩展参数

channelParamInfo

JSONObject

否

渠道参数信息（支付详情）

渠道返回时有值

详细

chnlFrontParamInfo

JSONObject

否

渠道参数信息（前端支付参数）

渠道返回时有值

详细

（1）扫码支付信息/ JS支付串信息（微信、支付宝、QQ钱包）

（2）交易验证方式（收银宝快捷）

（3）收银宝小程序收银台支付参数（innappid）

（4）收银宝手机安全控件支付参数（innappid）

respCode

String

5

是

业务返回码

respMsg

String

200

是

业务返回说明

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

是

商户订单号-退款订单号

orgRespTraceNum

String

40

是

原通联订单号

原消费、担保消费、平台转账订单

orderAmount

Long

20

是

退款总金额

单位：分。

1.【消费申请】退款，

上送退款列表：退款总金额=订单退款列表中（退款金额）之和；

不上送退款列表：退款总金额，不能大于原订单金额-平台抽佣金额-分账金额

2.【担保消费申请】退款：退款总金额=订单退款列表中（退款金额）之和；

3. 【转账申请】退款，“退款总金额”不能大于转账金额。

promotionAmount

Long

20

否

营销退款金额

单位：分

1.不能超过退款总金额；

2.不能超过原订单营销金额；

3.支持部分退款。

4.如不填，则不退营销退款金额,则“退款总金额”不能超过“原订单的订单金额-营销金额”

refundDetail

JSONArray

否

订单退款列表

1.【消费申请】退款：

（1）需要“平台抽佣退款或订单分账退款”时，需上送（仅支持1个列表）；

（2）不上送时，则不退款平台抽佣及分账退款资金；退款总金额不能大于“原订单订单金额-分账金额-平台抽佣金额”

2.【担保消费申请】退款，必填；

A．未担保确认：从应用担保户退款

B．已担保确认：从收款人簿记账户退款；

3.【转账申请】退款，不用上送

详情

isFundAllocation

String

1

否

是否需要调拨资金

0：否

1：是

注：默认“0：否”；

仅“通联存管”支持上送“1：是”，上送“1”，则从收付通将资金调拨回收银宝，实现退款。

respUrl

String

256

是

后台通知地址

如果不填，则不通知。

退款成功时，才会通知

chnlDiscAmt

JSONObject

否

优惠信息

此字段只适用于银联云闪付单品优惠交易的退货，含单品优惠交易只能整单退款，不支持部分退款

详情

extendParams

String

200

否

扩展信息

接口将原样返回，不可包含“|”及换行符+，空格，/，?，%，#，&，=等特殊字符，最多100个字符

字段

字段类型

字段长度

必填

字段名称

说明

result

String

1

否

订单状态

订单成功时会发订单结果通知商户。

详情

reqTraceNum

String

50

是

商户订单号

respTraceNum

String

40

是

通联订单号

extendParams

String

200

否

扩展信息

接口将原样返回，最多50个字符，不可包含“|”特殊字符

channelParamInfo

JSONObject

否

渠道参数信息

渠道返回时有值

详细

respCode

String

5

是

业务返回码

respMsg

String

200

是

业务返回说明

字段

字段类型

字段长度

必填

字段名称

说明

orgRespTraceNum

String

40

是

原通联订单号

若“商户订单号”和“通联订单号”均上送，以“通联订单号”查询

closeReason

String

100

否

关单原因

微企付必填

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

是

商户订单号

respTraceNum

String

40

是

通联订单号

closeResult

Long

1

是

订单关闭结果

1-关闭成功

2-关闭失败

closeFinishTime

String

20

否

订单关闭完成时间

订单关闭成功时，返回

result

String

1

否

订单状态

订单成功时会发订单结果通知商户。

详情

respCode

String

5

是

业务返回码

respMsg

String

200

是

业务返回说明

字段

字段类型

字段长度

必填

字段名称

说明

respTraceNum

String

40

是

通联订单号

verifyCode

String

6

是

短信验证码

字段

字段类型

字段类型

必填

字段名称

说明

result

String

1

否

订单状态

订单成功时会发订单结果通知商户。

详情

reqTraceNum

String

50

是

商户订单号

respTraceNum

String

40

是

通联订单号

respCode

String

5

是

业务返回码

respMsg

String

200

是

业务返回说明

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

是

请求流水号

oriRespTraceNum

String

是

通联订单号

待确认的通联订单号

confirmResult

String

是

确认结果

SUCCESS：成功   FAIL：失败 

remark

String

否

确认结果说明

字段

字段类型

字段类型

必填

字段名称

说明

respTraceNum

String

否

响应流水号

业务正常处理，则返回

respCode

String

是

业务返回码

respMsg

String

是

失败原因

如：订单已终态，不可重复确认！

字段

字段类型

必填

字段名称

说明

reqTraceNum

String

是

商户业务订单号

该笔业务订单由平台商户端生成的业务订单号

payerSignNum

String

是

付款商户会员编号（资金转出方）

payerSubAcctNo

String

是

付款商户银行子账号

上送银行用户编号

payerName

String

是

付款商户会员名称（资金转出方）

receiverList

JSONArray

否

收款商户信息列表

若上送，必须同时上送

说明：收款总金额等于列表中收款金额总和

若平台会员编号，上送#yunBizUserId_B2C#

totalAmount

Long

否

收款用户收款总金额，单位：分

receiverSignNum

String

否

收款商户会员编号（资金转入方）

若平台会员编号，上送#yunBizUserId_B2C

四个字段信息若上送，必须同时上送

说明：收款商户用户信息与列表信息，仅可以二选一

receiverSubAcctNo

String

否

收款商户银行子账号

receiverName

String

否

收款商户会员名称（资金转入方）

receiveAmount

Long

否

收款用户收款金额，单位：分

tradeAmount

Long

是

交易金额，单位分

selfFlag

String

是

平台商户自有资金交易类型

D：平台优惠

C：平台分成

N：无资金动账

当“平台商户自有资金交易类型”为C时，交易金额=收款用户收款金额+平台商户自有资金交易金额

当“平台商户自有资金交易类型”为D时，交易金额+平台商户自有资金交易金额=收款用户收款金额

新网银行，仅支持上送C：平台分成

selfAmount

Long

是

平台商户自有资金交易金额，单位：分

例如：89.00元，金额不能为负数。

P_ SELF_FLAG为C时，应小于交易金额。

P_ SELF_FLAG为N时，该字段金额应为0.00

fundType

String

否

资金类型/商品信息

remark

String

否

备注

extendParams

String

否

拓展参数

JSON格式

{“authId”：“88888888888”}

字段

字段类型

必填

字段名称

说明

receiverSignNum

String

否

收款商户会员编号（资金转入方）

 若平台会员编号，上送#yunBizUserId_B2C#

receiverSubAcctNo

String

是

收款商户银行子账号

receiverName

String

否

收款商户会员名称（资金转入方）

receiveAmount

Long

是

收款用户收款金额，单位：分

platSepTraceNum

String

是

平台分账
流水号

字段

字段类型

必填

字段名称

说明

result

String

否

订单状态

 进行中

交易成功

交易失败

respTraceNum

String

是

通联订单号

reqTraceNum

String

是

商户订单号（支付订单）

chnlTradeCode

String

否

银行侧交易流水号

chnlTradeCode返回新网银行“好惠通流水号”

chnlTradeDate

String

否

银行侧交易日期

chnlTradeTime

String

否

银行侧交易时间

respCode

String

是

业务返回码

00000：代表成功

66666、66667：处理中，即当前的请求已受理，需要继续调用关联的确认类接口，或通过发起订单查询、等待异步通知，来获取处理状态。

其他返回码：均代表失败

respMsg

String

否

业务返回说明

receiverList

JSONArray

否

收款用户信息列表

字段

字段类型

必填

字段名称

receiverSignNum

String

是

收款商户会员编号（资金转入方）

receiverSubAcctNo

String

是

收款商户银行子账号

receiverName

String

否

收款商户会员名称（资金转入方）

receiveAmount

Long

是

收款用户收款金额，单位：分

platSepTraceNum

String

是

平台分账流水号

bankSepTraceNum

String

是

银行侧分账流水号

字段

字段类型

必填

字段名称

说明

signNum

String

是

商户会员编号

支持平台提现，上送#yunBizUserId_B2C#

新网银行不支持平台提现

subAcctNo

String

否

银行子账号

只有平台提现，才可以非必填

reqTraceNum

String

是

商户订单号

全局唯一，不可重复

不可包含“|”字符

tradeAmount

Long

是

订单金额

单位：分

couponAmount

Long

否

抽佣金额（手续费）

单位：分

新网银行，支持上送

withdrawType

String

否

提现方式

提现方式,T0：T0提现（当日到账）

T1：T1提现

新网银行，支持上送

respUrl

String

是

后台通知地址

payMode

String

是

支付模式

固定：WITHDRAW_BANK

acctNum

String

是

银行卡号

showPayerAcctNo

String

否

显示付款账号

华通银行若填，必须为发起交易的记账簿账户号码，否则交易失败

华通银行支持上送

showPayerAcctName

String

否

显示付款户名

华通银行若填，必须为发起交易的记账簿账户户名，否则交易失败

华通银行支持上送

acctName

String

否

账户名

上送，则校验【银行卡管理】菜单银行卡记录是否存在：

存在：校验“银行账户名”是否一致；

不存在：则透传银行；

不上送，则校验银行卡是否存在，

存在：则取【银行卡管理】菜单“银行账户名”上送；

不存在：则要求必填；

summary

String

否

摘要

extendParams

String

否

扩展信息

原样返回

字段

字段类型

必填

字段名称

说明

result

String

否

订单状态

respTraceNum

String

是

通联订单号

reqTraceNum

String

是

商户订单号（支付订单）

chnlTradeCode

String

否

银行交易流水号

透传“中信银行流水号”

extendParams

String

否

扩展信息

respCode

String

是

业务返回码

00000：代表成功

66666、66667：处理中，即当前的请求已受理，需要继续调用关联的确认类接口，或通过发起订单查询、等待异步通知，来获取处理状态。

其他返回码：均代表失败

respMsg

String

是

业务返回说明

字段

字段类型

必填

字段名称

说明

reqTraceNum

String

是

退款订单号

该笔业务订单由平台商户端生成的业务订单号

reqSubTraceNum

String

否

退款子订单号

该笔业务订单下每笔业务子订单由平台商户端生成的唯一标识

商户业务订单号+商户业务子订单号应保证唯一。

新网银行，无需上送

oriRespTraceNum

String

是

原通联订单号

receiverSignNum

String

是

原支付交易付款用户编号（资金转入方）

 原收款用户信息

 若平台会员编号，上送#yunBizUserId_B2C#

receiverSubAcctNo

String

是

原支付交易付款用户银行子账号

上送银行用户编号

receiverName

String

是

原支付交易付款用户名称（资金转入方）

payerSignNum

String

是

原支付交易收款用户编号（资金转出方）

payerSubAcctNo

String

是

原支付交易收款用户银行子账号

上送银行用户编号

payerName

String

是

原支付交易收款用户名称（资金转出方）

receiveAmount

Long

是

原支付交易收款用户退款金额，单位：分

为原支付交易收款用户退款金额

tradeAmount

Long

是

交易金额，单位：分

为原支付付款用户退款金额

selfFlag

String

是

平台商户自有资金交易类型

N：无资金动账

D：扣平台自有资金登记薄

C：入平台自有资金登记薄

如不为N，应与原支付交易资金方向相反，即原支付交易该字段为D，退款交易该字段应为C。

当原支付交易“平台商户自有资金交易类型”为C时（退款交易该字段送D），交易金额=原支付交易收款用户退款金额+平台商户自有资金退款金额

当原支付交易“平台商户自有资金交易类型”为D时（退款交易该字段送C），交易金额+平台商户自有资金退款金额=原支付交易收款用户退款金额

华通银行，此字段仅上送“N:无资金动账”

新网银行，此字段仅支持上送“N:无资金动账”

selfAmount

Long

是

平台商户自有资金退款金额，单位：分

P_ SELF _FLAG为N时，该字段应为0

“中信银行托管”，必填；

   华通银行，上送0；

fundType

String

否

资金类型/商品名称

remark

String

否

备注

字段

字段类型

必填

字段名称

说明

respTraceNum

String

否

通联订单号

必填字段校验均通过，返回此字段

chnlTradeCode

String

否

银行侧交易流水号

业务返回码=00000，返回

chnlTradeDate

String

否

银行侧交易日期

chnlTradeTime

String

否

银行侧交易时间

respCode

String

是

业务返回码

00000：代表成功

66666、66667：处理中，即当前的请求已受理，需要继续调用关联的确认类接口，或通过发起订单查询、等待异步通知，来获取处理状态。

其他返回码：均代表失败

respMsg

String

否

业务返回说明

字段

字段类型

必填

字段名称

reqTraceNum

String

是

商户订单号-退款订单号

oriRespTraceNum

String

是

原通联订单号

bankRefundAmt

Long

是

银行侧退款金额

reason

String

否

退款原因

summary

String

否

摘要

字段

字段类型

必填

字段名称

result

String

否

订单状态

respMsg

String

否

订单失败信息

reqTraceNum

String

是

商户订单号

respTraceNum

String

是

通联订单号

respCode

String

是

业务返回码

respMsg

String

是

业务返回说明

字段

字段类型

字段长度

必填

字段名称

说明

result

String

1

是

订单状态

订单成功和失败时都会通知商户

详情

respMsg

String

200

否

错误信息

订单状态“交易失败”时，有值

reqTraceNum

String

50

是

商户订单号（支付订单）

respTraceNum

String

40

是

通联订单号

orgRespTraceNum

String

40

否

原云商通订单号

退款订单该字段才返回

orgReqTraceNum

String

50

否

原商户订单号

退款订单该字段才返回

orderAmount

Long

20

是

订单金额

单位：分

finishTime

String

20

否

订单支付完成时间

云商通订单支付完成时间

yyyy-MM-dd HH:mm:ss

signNum

String

60

否

商户会员编号-付款人

receiverSignNum

String

60

否

商户会员编号-收款人

仅消费和转账

transferResult

String

1

否

退款资金调拨结果

0：调拨失败

1：调拨成功

注:仅【退款申请】接口：

“isFundAllocation-是否需要资金调拨”字段，上送值为“1：是”且原订单为“收银宝渠道”退款的情况下做如下返回：

（1）“1：调拨成功”-收付通资金调拨收银宝成功

（2）“0：调拨失败”-收付通金调拨收银宝失败

transferAmount

Long

200

否

调拨金额

单位：分

extendParams

String

200

否

扩展参数

接口将原样返回，不可包含“|”特殊字符

channelParamInfo

JSONObject

否

渠道参数信息（支付详情）

渠道返回时有值

详细

字段

字段类型

字段长度

必填

字段名称

说明

openBankNo

String

4

否

开户银行编码

银行存管模式，返回

1024：新网银行

chnlTradeCode

String

50

是

渠道流水号

渠道端流水号

reqTraceNum

String

50

否

商户订单号

“商户订单号”值赋值为“渠道流水号”

说明：针对“7：应用银行账户”场景，入账失败自动退款场景，无值

respTraceNum

String

40

否

通联订单号

说明：针对“7：应用银行账户”场景，入账失败自动退款场景，无值

payAcctNo

String

32

是

来款账号

打款付款方账号

payAcctName

String

32

否

来款账户名

打款付款方账户名

仅“UCP”渠道有值

receiveAcctType

String

1

是

入账账户类型

1：簿记账户

2：支付账户

3:待结算户

4:储值卡待结算户

5：应用营销账户

6：应用储值卡账户

7：应用银行账户

signNum

String

60

是

入账商户会员编号

若为“#yunBizUserId_B2C#”，则表示平台上账；

说明：针对“7：应用银行账户”场景，入账失败自动退款场景，无值

inAcctNo

String

32

否

入账账号

1. “入账账户类型” 为“支付账户”时，有值，返回“支付账户号”
2. “入账账户类型”为待结算户、储值卡待结算户，返回待结算户、储值卡待结算户账户号（非15+账户号+2/3格式）

inAcctName

String

32

否

入账会员名称

入账会员户名

orderAmount

Long

20

是

入账金额

汇入金额

单位：分

transDateTime

String

20

是

入账时间

YYYY-MM-DD hh:mm:ss

result

Long

1

是

入账状态

1：入账成功

2：入账失败

5：待入金确认

message

String

200

否

入账失败说明

入账失败说明

summary

String

100

否

交易附言

渠道附言

remark

String

100

否

备注

备注

字段

字段类型

必填

字段名称

说明

signNum

String

是

商户系统用户标识，商户系统中唯一编号。

原订单会员
若平台，则为固定值：#yunBizUserId_B2C#

acctType

String

是

账户类型，见账户类型字典

1：薄记账户

2：银行子账户

reqTraceNum

是

商户订单号

生成退票订单时，云商通系统生成商户订单号

respTraceNum

String

是

通联订单号

refundStatus

String

是

退票状态

1-交易成功

2-交易失败

orgReqTraceNum

String

是

原商户订单号

发生退票的原商户订单号

orgRespTraceNum

String

是

原通联订单号

发生退票的原通联订单号

orderAmount

Long

是

订单金额

退票金额，单位：分

couponAmount

Long

是

平台抽佣金额

finishTime

String

是

退票完成时间

yyyy-MM-dd HH:mm:ss

refundReason

String

否

退票原因

字段

字段类型

字段长度

必填

字段名称

说明

respTraceNum

String

40

否

通联订单号

1.“通联订单号”与“商户订单号+订单创建日期”，必传其中一种

2.使用“商户订单号”查询时，必须传“订单创建日期”。

为确保订单查询效率，建议使用通联单号

reqTraceNum

String

50

否

商户订单号

oriTransDate

String

8

否

订单创建日期

格式：yyyyMMdd

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

是

商户订单号

respTraceNum

String

40

是

通联订单号

result

String

1

否

订单状态

详情

orderAmount

Long

20

是

订单金额

payAmount

Long

20

否

支付金额

finishTime

String

20

否

订单支付完成时间

订单终态时，有值

respCode

String

5

是

业务返回码

respMsg

String

200

是

业务返回说明

字段

字段类型

字段长度

必填

字段名称

说明

respTraceNum

String

40

否

通联订单号

1.“通联订单号”与“商户订单号+订单创建日期”，必传其中一种

2.使用“商户订单号”查询时，必须传“订单创建日期”。

为确保订单查询效率，建议使用通联单号

reqTraceNum

String

50

否

商户订单号

oriTransDate

String

8

否

订单创建日期

格式：yyyyMMdd

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

是

商户订单号

respTraceNum

String

40

是

通联订单号

result

String

1

否

订单状态

orgReqTraceNum

String

50

否

云商通原订单号

退款时才返回

orgRespTraceNum

String

40

否

原商户订单号

退款时才返回

orderAmount

Long

20

是

订单金额

payAmount

Long

20

否

支付金额

finishTime

String

20

否

订单支付完成时间

yyyy-MM-dd HH:mm:ss

signNum

String

60

是

商户会员编号-付款人

extendParams

String

200

否

扩展参数

订单接口信息原样返回，不可包含“|”特殊字符

channelParamInfo

JSONObject

否

渠道参数信息（支付详情）

渠道返回时有值

详细

respCode

String

5

是

业务返回码

respMsg

String

200

是

业务返回说明

字段

字段类型

字段长度

必填

字段名称

说明

fileDate

String

8

是

对账文件日期

YYYYMMDD

fileType

String

2

是

文件类型

1：txt文件

2：excel文件

3：银行余额对账文件