退款交易 0150000903、取现交易 059000
中 国 银 联 股 份 有 限 公 司 企 业 标 准
Q/CUP
Q/CUP xxx.x.x—2018
银联云闪付合作伙伴开放平台接入指南
（服务商版）
版本号：1.34
2018-**-**发布
2018-**-**实施
中国银联股份有限公司
发布
I
中国银联股份有限公司（以下简称“中国银联”）对该规范文档保留全部
知识产权权利，包括但不限于版权、专利、商标、商业秘密等。任何人对该
规 范 文 档 的 任 何 使 用 都 要 受 限 于 在 中 国 银 联 成 员 机 构 服 务 平 台
（http://member.unionpay.com/）与中国银联签署的协议之规定。中国银联
不对该规范文档的错误或疏漏以及由此导致的任何损失负任何责任。中国银
联针对该规范文档放弃所有明示或暗示的保证,包括但不限于不侵犯第三方
知识产权。
未经中国银联书面同意，您不得将该规范文档用于与中国银联合作事项
之外的用途和目的。未经中国银联书面同意，不得下载、转发、公开或以其
它任何形式向第三方提供该规范文档。如果您通过非法渠道获得该规范文档，
请立即删除，并通过合法渠道向中国银联申请。
中国银联对该规范文档或与其相关的文档是否涉及第三方的知识产权
（如加密算法可能在某些国家受专利保护）不做任何声明和担保，中国银联
对于该规范文档的使用是否侵犯第三方权利不承担任何责任，包括但不限于
对该规范文档的部分或全部使用。
版本控制信息
版本
日期
修订人
说明
1.01
20180828
初始配置
1.02
20180903
合并交易与进件资料部分
1.03
20180904
统一数据元说明、修改审核字段名称
1.04
20180904
增加统一订单部分内容
1.06
20180905
修改和并批注
1.07
20180905
上传图片接口合并遗漏增补
1.08
20180905
修改报文签名和验签内容与银联体系内要求保
持一致
1.09
20180905
修改 rate 费率描述
1.10
20180906
删除多余的参数说明，调整格式
1.11
20180906
增加商户进件异步通知回调，合并交易部分调整
1.12
20180906
增加微信参数配置
1.13
20180907
统一下单支付增加场景信息参数、订单关闭接口
订单类型枚举说明
1.14
20180907
修改手续费
1.15
20180907
修改增加费率、证件类型
1.16
20180907
法人身份证背面照片改为可选
1.17
20180908
更新报文数据元描述，去掉部分已废弃字段；简
化商户资料查询返回的数据信息
1.18
20180910
调整文档目录结构
1.19
20180911
商户信息录入去掉“被授权人证件到期日”
1.21
20180912
1. 微信配置接口拆分为 3 个接口
2. 商户信息录入增加字段“微信渠道商号、支
付宝 pid”
3. 商户信息录入增加字段“审核结果回调通知
地址”
4. 商户信息录入增加字段“云闪付商户号、收
单机构商户号”
1.22
20180912
1. 请求请求报文增加收单机构服务商编号
2. 请求请求报文增加收单机构服务商签名
3. 时间格式统一改为 yyyyMMddHHmmss
1.23
20180912
1. 修改文档中部分参数名
1.24
20180913
进件通知、支付通知 修改返回报文格式
1.25
20180913
增加商户入驻、交易应答码
1.26
20180914
结算周期 T+1；D+0 修改为 1：T+1；2：D+0
1.27
20180914
服务商进件 acqSpId 改为 serProvId
银联云闪付合作伙伴开放平台技术指南（服务商版）
2
版本
日期
修订人
说明
1.28
20180917
1. 增加字段示例
2. 交易状态取值定义
3. 退款状态取值定义
4. 增加支付宝可折扣金额参数、产品编码参数
5. 统一下单增加支付宝 H5 支付、支付宝 APP 支
付定义
1.29
20180918
增加返回付款用户账号
1.30
20180918
增加个人进件
1.31
20180926
1. json 格式修改 json 格式字符串
2. 扣率封顶值传 0 表示不封顶
1.32
20180929
商户信息修改，paper 和 rate 必选修改为可选
1.33
20181008
1. 付款码支付、查询订单接口返回报文中增加
应结订单金额字段：settlementAmt
2. 支付通知接口请求报文中增加应结订单金额
字段：settlementAmt
1.34
20181012
1. 统一名词解释
2. 增加请求、返回报文示例
银联云闪付合作伙伴开放平台技术指南（服务商版）
3
目录
版本控制信息 ............................................................................................................................................. 1
目录 3
前 言 ...................................................................................................................................................... 7
银联云闪付合作伙伴开放平台技术指南 ................................................................................................. 8
（服务商版） ........................................................................................................................................... 8
1 范围 .................................................................................................................................................. 8
2 名词 .................................................................................................................................................. 8
3 引用 .................................................................................................................................................. 8
4 通信方式 .......................................................................................................................................... 8
5 协议规则 .......................................................................................................................................... 8
5.1 报文格式 ........................................................................................................................................ 8
5.2 字符编码 ........................................................................................................................................ 8
5.3 报文签名和验签 ............................................................................................................................ 8
6 交易流程 .......................................................................................................................................... 9
6.1 付款码支付 .................................................................................................................................... 9
6.1.1
消费
........................................................................................................................................ 9
6.1.2
消费撤销
................................................................................................................................ 9
6.2 扫码支付 ...................................................................................................................................... 10
6.3 60 退货及查询 ............................................................................................................................. 11
6.3.1
交易查询
.............................................................................................................................. 11
6.3.2
退货
...................................................................................................................................... 11
6.3.3
退货查询
.............................................................................................................................. 11
6.4 商户入驻 ...................................................................................................................................... 11
6.4.1
商户信息录入
...................................................................................................................... 11
6.4.2
商户信息修改
...................................................................................................................... 12
6.4.3
商户信息查询
...................................................................................................................... 12
7 报文数据元说明 ............................................................................................................................. 12
7.1 数据元类型定义 .......................................................................................................................... 12
7.2 数据元说明 .................................................................................................................................. 13
7.2.1
serProvId
............................................................................................................................ 13
7.2.2
merchantType
...................................................................................................................... 13
7.2.3
merId
.................................................................................................................................... 13
7.2.4
acqOrgCode
.......................................................................................................................... 14
7.2.5
acqMerId
.............................................................................................................................. 14
7.2.6
businessLicenseType
........................................................................................................ 14
7.2.7
businessLicenseCode
........................................................................................................ 14
7.2.8
businessLicensePhoto
...................................................................................................... 15
7.2.9
businessLicenseExpired
.................................................................................................. 15
7.2.10
industryCategoryId
.......................................................................................................... 15
7.2.11
province
.............................................................................................................................. 16
7.2.12
city
...................................................................................................................................... 16
7.2.13
area
...................................................................................................................................... 16
7.2.14
businessAddress
................................................................................................................ 16
7.2.15
storeShopPhoto
.................................................................................................................. 17
7.2.16
storeHeadPhoto
.................................................................................................................. 17
7.2.17
storeHallPhoto
.................................................................................................................. 17
银联云闪付合作伙伴开放平台技术指南（服务商版）
4
7.2.18
storeCashierPhoto
............................................................................................................ 17
7.2.19
lawyerName
.......................................................................................................................... 18
7.2.20
lawyerCertType
.................................................................................................................. 18
7.2.21
lawyerCertNo
...................................................................................................................... 18
7.2.22
lawyerCertPhotoFront
...................................................................................................... 18
7.2.23
lawyerCertPhotoBack
........................................................................................................ 19
7.2.24
contactPerson
.................................................................................................................... 19
7.2.25
contactPhone
...................................................................................................................... 19
7.2.26
serviceTel
.......................................................................................................................... 19
7.2.27
email
.................................................................................................................................... 20
7.2.28
acquiringAgreementPhoto
................................................................................................ 20
7.2.29
settlePeriod
...................................................................................................................... 20
7.2.30
settleAccountType
............................................................................................................ 21
7.2.31
settleAccountNo
................................................................................................................ 21
7.2.32
bankAccountName
................................................................................................................ 21
7.2.33
bankCardPhotoFront
.......................................................................................................... 21
7.2.34
bankCardPhotoBack
............................................................................................................ 22
7.2.35
openingLicenseAccountPhoto
.......................................................................................... 22
7.2.36
openBank
.............................................................................................................................. 22
7.2.37
openSubBank
........................................................................................................................ 22
7.2.38
openBankCode
...................................................................................................................... 23
7.2.39
openBankReservePhone
...................................................................................................... 23
7.2.40
settleAuthLetterPhoto
.................................................................................................... 23
7.2.41
authorizedPersonCertType
.............................................................................................. 23
7.2.42
authorizedPersonCertNo
.................................................................................................. 24
7.2.43
authorizedCertPhotoFront
.............................................................................................. 24
7.2.44
authorizedCertPhotoBack
................................................................................................ 24
7.2.45
feeRateAlipay
.................................................................................................................... 24
7.2.46
feeRateWechatpay
.............................................................................................................. 25
7.2.47
bankCardRateLevel1
.......................................................................................................... 25
7.2.48
bankCardRateLevel2
.......................................................................................................... 25
7.2.49
feeRateUnionpayDebit
...................................................................................................... 26
7.2.50
feeRateUnionpayDebitCap
................................................................................................ 26
7.2.51
feeRateUnionpayCredit
.................................................................................................... 26
7.2.52
reserve1
.............................................................................................................................. 26
7.2.53 wechatChannelId .................................................................................................................. 27
7.2.54 alipayChannelId .................................................................................................................... 27
7.2.55
auditStatus
........................................................................................................................ 27
7.2.56
auditMsg
.............................................................................................................................. 27
7.2.57
auditTime
............................................................................................................................ 28
7.2.58
areaInfo
.............................................................................................................................. 28
7.2.59
backUrl
................................................................................................................................ 28
7.2.60
orderType
............................................................................................................................ 29
7.2.61
payData
................................................................................................................................ 29
7.2.62
userId
.................................................................................................................................. 30
7.2.63
transIndex
.......................................................................................................................... 30
7.2.64
termInfo
.............................................................................................................................. 31
7.2.65
termId
.................................................................................................................................. 31
7.2.66
storeId
................................................................................................................................ 32
7.2.67
txnAmt
.................................................................................................................................. 32
7.2.68
respMsg
................................................................................................................................ 32
7.2.69
respCode
.............................................................................................................................. 32
7.2.70
reqReserved
........................................................................................................................ 33
银联云闪付合作伙伴开放平台技术指南（服务商版）
5
7.2.71
authCode
.............................................................................................................................. 33
7.2.72
qrCode
.................................................................................................................................. 33
7.2.73
payTime
................................................................................................................................ 34
7.2.74
paymentValidTime
.............................................................................................................. 34
7.2.75
payerInfo
............................................................................................................................ 34
7.2.76
operatorId
.......................................................................................................................... 34
7.2.77
orderInfo
............................................................................................................................ 35
7.2.78
orderNo
................................................................................................................................ 35
7.2.79
orderTime
............................................................................................................................ 35
7.2.80
origOrderNo
........................................................................................................................ 36
7.2.81
origRespCode
...................................................................................................................... 36
7.2.82
origRespMsg
........................................................................................................................ 36
7.2.83
payAmt
.................................................................................................................................. 36
7.2.84 settlementAmt ...................................................................................................................... 37
7.2.85
limitPay
.............................................................................................................................. 37
7.2.86
frontUrl
.............................................................................................................................. 37
7.2.87
currencyCode
...................................................................................................................... 37
7.2.88
customerIp
.......................................................................................................................... 38
7.2.89 productId .............................................................................................................................. 38
7.2.90 discountableAmt ................................................................................................................... 38
8 交易报文 ........................................................................................................................................ 39
8.1 公共说明 ...................................................................................................................................... 39
8.1.1
报文结构
.............................................................................................................................. 39
8.1.2
符号约定
.............................................................................................................................. 39
8.1.3
接口说明
.............................................................................................................................. 39
8.2 商户信息录入 .............................................................................................................................. 40
8.2.1
场景说明
.............................................................................................................................. 40
8.2.2
接口说明
.............................................................................................................................. 40
8.2.3
业务参数
.............................................................................................................................. 40
8.3 商户信息修改 .............................................................................................................................. 43
8.3.1
场景说明
.............................................................................................................................. 43
8.3.2
接口说明
.............................................................................................................................. 43
8.3.3
业务参数
.............................................................................................................................. 43
8.4 商户信息查询 .............................................................................................................................. 44
8.4.1
场景说明
.............................................................................................................................. 44
8.4.2
接口说明
.............................................................................................................................. 44
8.4.3
业务参数
.............................................................................................................................. 44
8.5 商户进件通知异步回调 .............................................................................................................. 45
8.5.1
场景说明
.............................................................................................................................. 45
8.5.2
接口说明
.............................................................................................................................. 45
8.5.3
业务参数
.............................................................................................................................. 45
8.6 微信参数配置-支付授权目录 ..................................................................................................... 45
8.6.1
场景说明
.............................................................................................................................. 45
8.6.2
接口说明
.............................................................................................................................. 46
8.6.3
业务参数
.............................................................................................................................. 46
8.7 微信参数配置-子商户 APPID ....................................................................................................... 46
8.7.1
场景说明
.............................................................................................................................. 46
8.7.2
接口说明
.............................................................................................................................. 46
8.7.3
业务参数
.............................................................................................................................. 46
8.8 微信参数配置-推荐关注 APPID.................................................................................................... 46
8.8.1
场景说明
.............................................................................................................................. 46
8.8.2
接口说明
.............................................................................................................................. 46
8.8.3
业务参数
.............................................................................................................................. 46
银联云闪付合作伙伴开放平台技术指南（服务商版）
6
8.9 图片上传 ...................................................................................................................................... 47
8.9.1
场景说明
.............................................................................................................................. 47
8.9.2
接口说明
.............................................................................................................................. 47
8.9.3
业务参数
.............................................................................................................................. 47
8.10 统一下单支付 .............................................................................................................................. 47
8.10.1
场景说明
.............................................................................................................................. 47
8.10.2
接口说明
.............................................................................................................................. 47
8.10.3
业务参数
.............................................................................................................................. 47
8.11 扫码支付 ...................................................................................................................................... 49
8.11.1
场景说明
.............................................................................................................................. 49
8.11.2
接口说明
.............................................................................................................................. 49
8.11.3
业务参数
.............................................................................................................................. 49
8.12 付款码支付 .................................................................................................................................. 50
8.12.1
场景说明
.............................................................................................................................. 50
8.12.2
接口说明
.............................................................................................................................. 50
8.12.3
业务参数
.............................................................................................................................. 50
8.13 撤销订单 ...................................................................................................................................... 51
8.13.1
场景说明
.............................................................................................................................. 51
8.13.2
接口说明
.............................................................................................................................. 51
8.13.3
业务参数
.............................................................................................................................. 52
8.14 关闭订单 ...................................................................................................................................... 52
8.14.1
场景说明
.............................................................................................................................. 52
8.14.2
接口说明
.............................................................................................................................. 52
8.14.3
业务参数
.............................................................................................................................. 52
8.15 查询订单 ...................................................................................................................................... 53
8.15.1
场景说明
.............................................................................................................................. 53
8.15.2
接口说明
.............................................................................................................................. 53
8.15.3
业务参数
.............................................................................................................................. 53
8.16 申请退款 ...................................................................................................................................... 54
8.16.1
场景说明
.............................................................................................................................. 54
8.16.2
接口说明
.............................................................................................................................. 54
8.16.3
业务参数
.............................................................................................................................. 54
8.17 退款查询 ...................................................................................................................................... 54
8.17.1
场景说明
.............................................................................................................................. 54
8.17.2
接口说明
.............................................................................................................................. 54
8.17.3
业务参数
.............................................................................................................................. 54
8.18 支付通知 ...................................................................................................................................... 55
8.18.1
场景说明
.............................................................................................................................. 55
8.18.2
接口说明
.............................................................................................................................. 55
8.18.3
业务参数
.............................................................................................................................. 55
附录一 入件报文应答码........................................................................................................................ 55
附录二 交易报文应答码........................................................................................................................ 56
银联云闪付合作伙伴开放平台技术指南（服务商版）
7
前 言
本指南对服务商接入中国银联合作伙伴开放平台，进行商户注册、资料修改、查询以及交
易报文接口做了规定和引导。
本标准由中国银联股份有限公司提出。
本标准由中国银联股份有限公司制定。
本标准起草单位：中国银联股份有限公司。
本标准主要起草人：云闪付事业部。
银联云闪付合作伙伴开放平台技术指南（服务商版）
8
银联云闪付合作伙伴开放平台技术指南
（服务商版）
1 范围
本指南对服务商与中国银联云闪付合作伙伴平台之间进行二维码支付（包括付款码支付、
扫码支付）交易时使用的交易流程、报文接口做了规定。
本指南适用于所有接入中国银联云闪付合作伙伴开放平台的服务商。
2 名词
中国银联云闪付合作伙伴开放平台：以下简称“平台”。
3 引用
《中国银联二维码交易处理系统技术指南》
《中国银联银行卡交换系统技术规范》
《银联卡跨行业务地区代码标准》
4 通信方式
服务商与平台之间采用HTTP/HTTPS方式通信。支持公网和专线两种传输方式：公网传输时，
协议为标准HTTPS；专网传输时，协议为标准HTTP。
5 协议规则
5.1 报文格式
服务商与平台间的报文采用 JSON 格式，通过 POST 方式提交。
报文后续可能会新增字段，服务商应对新增的字段不敏感，若服务商不关心该字段，可直
接丢弃。
5.2 字符编码
统一采用 UTF-8 格式编码：单个中文字符长度为三个字节、英文或数字字符为一个字节。
5.3 报文签名和验签
对于报文的签名处理机制如下：
首先，对报文中出现签名域（signature）之外的所有数据元按照key的ascii顺序排序，并
以&作为连接符拼接成待签名串（即key1=value1&key2=value2…）。然后，对待签名串使用
SHA-256做摘要（摘要结果转16进制小写字符串），并使用服务商自己申请的RSA私钥对摘要做
签名操作。最后，对签名做Base64编码，将编码后的签名串放在签名（signature）域里和其他
报文域一起上送给合作伙伴平台。
对于报文的验签处理机制如下：
首先，对报文中出现签名域（signature）之外的所有数据元按照key的ascii顺序排序，然
后以&作为连接符拼接成待签名串。
其次，对待签名串使用SHA-256算法做摘要（摘要结果转成16进制小写字符串），再使用平
台给服务商提供的RSA公钥钥证书对摘要和报文中的签名信息做签名验证操作。
银联云闪付合作伙伴开放平台技术指南（服务商版）
9
6 交易流程
6.1 付款码支付
6.1.1 消费
付款人展示 APP 上的条码/二维码，商户收银员使用扫枪扫码，然后商户通过后台系统
向平台发起消费交易。
交易流程如下：
图1 C扫B消费流程
交易步骤：
1. APP 展示付款码（银联、微信或支付宝标准的付款码）。
2. 服务商使用扫码枪扫描用户手机 APP 展示的付款码。
3. 服务商向平台发起“付款码支付”交易。
4. 平台代表服务商向收单机构发起扣款交易，并将扣款结果通过“付款码支付”应答
返回给服务商。
6.1.2 消费撤销
服务商超时没有收到结果通知，向平台发起“C2B 消费撤销”交易，将原交易取消。
交易流程如下：
银联云闪付合作伙伴开放平台技术指南（服务商版）
10
图2 C扫B消费撤销流程
交易步骤：
1. 服务商向平台发起“C2B 消费撤销”交易，将原交易取消。
2. 平台返回撤销应答。
注：若服务商发出撤销交易后又收到了原消费的承兑应答，应直接丢弃该应答。
6.2 扫码支付
交易流程如下：
图3扫码支付流程
交易步骤：
1. 服务商向平台申请二维码，并展示。
2. APP 扫描服务商展示的二维码。
3. APP 向平台发起查询交易，获取二维码对应的订单。
4. APP 确认订单信息后向平台发起付款请求。
银联云闪付合作伙伴开放平台技术指南（服务商版）
11
5. 平台向收单机构发起扣款并将扣款结果通过“支付结果通知”交易发送给服务商，
通知该订单已被支付。
6.3 退货及查询
6.3.1 交易查询
交易流程如下：
图5交易查询交易流程
交易步骤：
1. 服务商向平台发起交易查询请求。
2. 平台向服务商返回交易应答。
6.3.2 退货
交易流程同“5.3.1-交易查询”。
6.3.3 退货查询
交易流程同“5.3.1-交易查询”。
6.4 商户入驻
6.4.1 商户信息录入
交易流程如下：
银联云闪付合作伙伴开放平台技术指南（服务商版）
12
6.4.2 商户信息修改
交易流程同“5.4.1-商户信息录入”。
6.4.3 商户信息查询
交易流程同“5.4.1-商户信息录入”。
7 报文数据元说明
7.1 数据元类型定义
Ax x 字节定长的字母字符
Ax..y 长度为 x-y 字节的变长字母字符
ANx x 字节定长的字母和/或数字字符
Anx..y 长度为 x-y 字节的变长字母和/或数字字符
ANSx x 字节定长的字母、数字和/或特殊符号字符
ANSx..y 长度为 x-y 字节的变长字母、数字和/或特殊符号字符
Asx x 字节定长的字母和/或特殊符号字符
Asx..y 长度为 x-y 字节的变长字母和/或特殊符号字符
Nx x 字节定长的整型数值，若表示金额，则以分为单位
Nx..y 长度为 x-y 字节的整型数值，若表示金额，则以分为单位
NSx x 字节定长的数字符和/或特殊字符
NSx..y 长度为 x-y 字节的数字字符和/或特殊字符
Sx x 字节定长的特殊符号字符
Sx..y 长度为 x-y 字节的变长特殊符号字符
ss 秒
DD 日
hh 时
MM 月
银联云闪付合作伙伴开放平台技术指南（服务商版）
13
mm 分
YY 年（2 字节）
YYYY 年（4 字节）
7.2 数据元说明
数据元标识首字母小写，如果包含多个单词的，后续单词首字母大写。
数据元可能会新增，服务商在处理报文时不应对新增的数据元敏感，若服务商不关心
该数据元，可直接丢弃。
7.2.1 serProvId
云闪付服务商标识
7.2.1.1 属性
AN 10
7.2.1.2 描述
服务商在云闪付合作伙伴开放平台中注册的唯一编号。
7.2.1.3 示例
CL01234567
7.2.2 merchantType
商户类型
7.2.2.1 属性
N1
7.2.2.2 描述
1：个体工商户 2：企业 3：个人
7.2.2.3 示例
"merchantType": 1
7.2.3 merId
云闪付合作伙伴开放平台入驻的商户号
7.2.3.1 属性
AN 20
7.2.3.2 描述
云闪付合作伙伴开放平台为入驻商户分配的唯一编号
银联云闪付合作伙伴开放平台技术指南（服务商版）
14
7.2.3.3 示例
7.2.4 acqOrgCode
收单机构代码
7.2.4.1 属性
AN 1..30
7.2.4.2 描述
收单机构在银联体系内注册的唯一编号
7.2.4.3 示例
"acqOrgCode": "69026276696"
7.2.5 acqMerId
收单机构商户号
7.2.5.1 属性
AN 20
7.2.5.2 描述
收单机构给商户分配的商户编号
7.2.5.3 示例
"acqMerId": "M1234567890123456781"
7.2.6 businessLicenseType
营业执照类型
7.2.6.1 属性
AN 1..30
7.2.6.2 描述
1：三证合一
2：普通
其中“普通”为老版营业执照
7.2.6.3 示例
" businessLicenseType": "1"
7.2.7 businessLicenseCode
营业执照号码
7.2.7.1 属性
AN 13..18
银联云闪付合作伙伴开放平台技术指南（服务商版）
15
7.2.7.2 描述
7.2.7.3 示例
"businessLicenseCode": "13131313131313"
7.2.8 businessLicensePhoto
营业执照照片地址
7.2.8.1 属性
AN 10..80
7.2.8.2 描述
调用商户图片接口返回的 url 地址
7.2.8.3 示例
6
" businessLicensePhoto": " https://www.isv001.com/dev/201809165639.png "
7.2.9 businessLicenseExpired
营业执照有效期（截至日）.
7.2.9.1 属性
AN 2..10
7.2.9.2 描述
无限期的请填写“长期”
7.2.9.3 示例
6
"businessLicenseExpired ": "20201010"
7.2.10 industryCategoryId
行业类目
7.2.10.1 属性
AN 1..20
7.2.10.2 描述
7.2.10.3 示例
"industryCategoryId ": "9527"
银联云闪付合作伙伴开放平台技术指南（服务商版）
16
7.2.11 province
注册省编号
7.2.11.1 属性
AN 2..10
7.2.11.2 描述
与经营地址一致
7.2.11.3 示例
"province ": "11"
7.2.12 city
注册市编号
7.2.12.1 属性
AN 1..10
7.2.12.2 描述
与经营地址一致
7.2.12.3 示例
"city ": "111"
7.2.13 area
注册区编号
7.2.13.1 属性
AN 1..10
7.2.13.2 描述
与经营地址一致
7.2.13.3 示例
"area ": "1111"
7.2.14 businessAddress
经营地址
7.2.14.1 属性
AN 10..80
7.2.14.2 描述
与营业执照上注册的地址一致
银联云闪付合作伙伴开放平台技术指南（服务商版）
17
7.2.14.3 示例
"businessAddress ": "成都市青羊区提督街 99 号恒大华置中心写字楼"
7.2.15 storeShopPhoto
门店外景照
7.2.15.1 属性
AN 10..80
7.2.15.2 描述
7.2.15.3 示例
" storeShopPhoto": "https://www.isv001.com/dev/201809165639.png"
7.2.16 storeHeadPhoto
门店门头照
7.2.16.1 属性
AN 10..80
7.2.16.2 描述
" storeHeadPhoto": "https://www.isv001.com/dev/201809165639.png"
7.2.16.3 示例
7.2.17 storeHallPhoto
门店内景照
7.2.17.1 属性
AN 10..80
7.2.17.2 描述
7.2.17.3 示例
"storeHallPhoto": "https://www.isv001.com/dev/201809165639.png"
7.2.18 storeCashierPhoto
门店收银台照
7.2.18.1 属性
AN 10..80
7.2.18.2 描述
银联云闪付合作伙伴开放平台技术指南（服务商版）
18
7.2.18.3 示例
"storeCashierPhoto": "https://www.isv001.com/dev/201809165639.png"
7.2.19 lawyerName
法人姓名
7.2.19.1 属性
AN 1..60
7.2.19.2 描述
7.2.19.3 示例
"lawyerName": "智君"
7.2.20 lawyerCertType
法人证件类型
7.2.20.1 属性
A1
7.2.20.2 描述
1：身份证；2：台胞证；3：港澳通行证；4：其他
7.2.20.3 示例
"lawyerCertType": "1"
7.2.21 lawyerCertNo
法人证件号码
7.2.21.1 属性
AN 15..18
7.2.21.2 描述
7.2.21.3 示例
"lawyerCertNo": "510198199910103598"
7.2.22 lawyerCertPhotoFront
法人证件正面照
7.2.22.1 属性
银联云闪付合作伙伴开放平台技术指南（服务商版）
19
AN 10..80
7.2.22.2 描述
7.2.22.3 示例
"lawyerPhotoFront": "https://www.isv001.com/dev/201809165639.png"
7.2.23 lawyerCertPhotoBack
法人证件背面照
7.2.23.1 属性
AN 10..80
7.2.23.2 描述
7.2.23.3 示例
"lawyerPhotoBack": "https://www.isv001.com/dev/201809165639.png"
7.2.24 contactPerson
联系人姓名
7.2.24.1 属性
AN 2..60
7.2.24.2 描述
7.2.24.3 示例
"contactPerson": "姬发"
7.2.25 contactPhone
联系人手机号码
7.2.25.1 属性
AN 11
7.2.25.2 描述
7.2.25.3 示例
"contactPhone": "13888888888"
7.2.26 serviceTel
客服电话
银联云闪付合作伙伴开放平台技术指南（服务商版）
20
7.2.26.1 属性
AN 5..15
7.2.26.2 描述
7.2.26.3 示例
"serviceTel": "83812345"
7.2.27 email
邮箱地址
7.2.27.1 属性
AN 5..50
7.2.27.2 描述
7.2.27.3 示例
"email": "xxx@163.com"
7.2.28 acquiringAgreementPhoto
商户收单协议照片
7.2.28.1 属性
AN 10..80
7.2.28.2 描述
按照收单机构提供的纸质协议文件填写后签章
7.2.28.3 示例
"acquiringAgreementPhoto": "https://www.isv001.com/dev/201809165639.png"
7.2.29 settlePeriod
结算周期
7.2.29.1 属性
N1
7.2.29.2 描述
可支持以下两种清算模式：
1：T+1;
2：D+0;
银联云闪付合作伙伴开放平台技术指南（服务商版）
21
7.2.29.3 示例
"settlePeriod": 1
7.2.30 settleAccountType
结算账户类型
7.2.30.1 属性
N1
7.2.30.2 描述
1：对公账户 2：法人账户 3：被授权人账户
7.2.30.3 示例
"settleAccountType": 1
7.2.31 settleAccountNo
银行卡号
7.2.31.1 属性
AN 10..30
7.2.31.2 描述
7.2.31.3 示例
"settleAccountNo": "622220255455656"
7.2.32 bankAccountName
开户姓名
7.2.32.1 属性
AN 2..60
7.2.32.2 描述
7.2.32.3 示例
"bankAccountName": "姬发"
7.2.33 bankCardPhotoFront
银行卡正面照
7.2.33.1 属性
AN 10..80
银联云闪付合作伙伴开放平台技术指南（服务商版）
22
7.2.33.2 描述
7.2.33.3 示例
"bankCardPhotoFront": "https://www.isv001.com/dev/201809165639.png"
7.2.34 bankCardPhotoBack
银行卡背面照
7.2.34.1 属性
AN 10..80
7.2.34.2 描述
7.2.34.3 示例
"bankCardPhotoBack": "https://www.isv001.com/dev/201809165639.png"
7.2.35 openingLicenseAccountPhoto
开户许可证照片
7.2.35.1 属性
AN 10..80
7.2.35.2 描述
对公户结算提交开户许可证，一般户结算提供银行出具的印鉴卡
7.2.35.3 示例
"openingLicenseAccountPhoto": "https://www.isv001.com/dev/201809165639.png"
7.2.36 openBank
开户银行名称
7.2.36.1 属性
AN 2..20
7.2.36.2 描述
7.2.36.3 示例
"openBank": "中国工商银行"
7.2.37 openSubBank
开户支行名称
7.2.37.1 属性
银联云闪付合作伙伴开放平台技术指南（服务商版）
23
AN 2..50
7.2.37.2 描述
7.2.37.3 示例
"openSubBank": "中国工商银行电子科技大学支行"
7.2.38 openBankCode
开户行联行号
7.2.38.1 属性
AN 4..20
7.2.38.2 描述
7.2.38.3 示例
"openBankCode": "11258559955"
7.2.39 openBankReservePhone
银行预留手机号
7.2.39.1 属性
A11
7.2.39.2 描述
7.2.39.3 示例
"openBankReservePhone": "13888888888"
7.2.40 settleAuthLetterPhoto
结算授权书
7.2.40.1 属性
AN 10..80
7.2.40.2 描述
按照收单机构提供的电子文档填写后签章，结算至被授权人账户
7.2.40.3 示例
"settleAuthLetterPhoto": "https://www.isv001.com/dev/201809165639.png"
7.2.41 authorizedPersonCertType
被授权人证件类型
银联云闪付合作伙伴开放平台技术指南（服务商版）
24
7.2.41.1 属性
A1
7.2.41.2 描述
1：身份证；2：台胞证；3：港澳通行证；4：其他
7.2.41.3 示例
"authorizedPersonCertType": "1"
7.2.42 authorizedPersonCertNo
被授权人证件号码
7.2.42.1 属性
AN 15..18
7.2.42.2 描述
7.2.42.3 示例
"authorizedPersonCertNo": "510586199910102365"
7.2.43 authorizedCertPhotoFront
被授权人证件正面照
7.2.43.1 属性
AN 10..80
7.2.43.2 描述
7.2.43.3 示例
"suthorizedCertPhotoFront": "https://www.isv001.com/dev/201809165639.png"
7.2.44 authorizedCertPhotoBack
被授权人证件背面照
7.2.44.1 属性
AN 10..80
7.2.44.2 描述
7.2.44.3 示例
"suthorizedCertPhotoBack": "https://www.isv001.com/dev/201809165639.png"
7.2.45 feeRateAlipay
银联云闪付合作伙伴开放平台技术指南（服务商版）
25
支付宝手续费率
7.2.45.1 属性
AN 1..4
7.2.45.2 描述
如:千分之 6。 则传 6。
7.2.45.3 示例
"feeRateAlipay": "6"
7.2.46 feeRateWechatpay
微信手续费率
7.2.46.1 属性
AN 1..4
7.2.46.2 描述
7.2.46.3 示例
"feeRateWechatpay": "6"
7.2.47 bankCardRateLevel1
银行卡二维码费率一档，交易金额大于 1000 元执行费率
7.2.47.1 属性
AN 1..4
7.2.47.2 描述
7.2.47.3 示例
"bankCardRateLevel1":{"feeRateUnionpayCredit":"0.03","feeRateUnionpayDebit":"0.04"
,"feeRateUnionpayDebitCap":"1000"}
7.2.48 bankCardRateLevel2
银行卡二维码费率二档，交易金额小于（含）1000 元执行费率
7.2.48.1 属性
AN 1..4
7.2.48.2 描述
7.2.48.3 示例
"bankCardRateLevel2":{"feeRateUnionpayCredit":"0.04","feeRateUnionpayDebit":"0.05"
,"feeRateUnionpayDebitCap":"100"}
银联云闪付合作伙伴开放平台技术指南（服务商版）
26
7.2.49 feeRateUnionpayDebit
银联手续费率(借记)
7.2.49.1 属性
AN 1..4
7.2.49.2 描述
7.2.49.3 示例
"feeRateUnionpayDebit":"0.03"
7.2.50 feeRateUnionpayDebitCap
银联手续费率(借记封顶)
7.2.50.1 属性
AN 1..8
7.2.50.2 描述
传 0 表示不封顶
7.2.50.3 示例
" feeRateUnionpayDebitCap":"100"
7.2.51 feeRateUnionpayCredit
银联手续费率(贷记)
7.2.51.1 属性
AN 1..4
7.2.51.2 描述
7.2.51.3 示例
"feeRateUnionpayCredit":"0.03"
7.2.52 reserve1
收单机构拓展域
7.2.52.1 属性
ANS 1..256
7.2.52.2 描述
若收单机构需要商户其他的材料，在拓展域中进行传送
银联云闪付合作伙伴开放平台技术指南（服务商版）
27
7.2.52.3 示例
"reserve1":"{\"key1\":\"value1\",\"key2\":\"value2\"}"
7.2.53 wechatChannelId
服务商微信渠道号
7.2.53.1 属性
ANS 1..64
7.2.53.2 描述
收单机构系统为服务商分配的微信渠道号
7.2.53.3 示例
"wechatChannelId":"123456"
7.2.54 alipayChannelId
服务商支付宝渠道号
7.2.54.1 属性
ANS 1..64
7.2.54.2 描述
收单机构系统为服务商分配的微信渠道号
7.2.54.3 示例
"alipayChannelId":"123456"
7.2.55 auditStatus
审核状态
7.2.55.1 属性
A3
7.2.55.2 描述
1：待审核 2：已完成 3：审核失败
7.2.55.3 示例
"auditStatus":"1"
7.2.56 auditMsg
审核失败原因
7.2.56.1 属性
银联云闪付合作伙伴开放平台技术指南（服务商版）
28
ANS 2..80
7.2.56.2 描述
7.2.56.3 示例
"auditMsg":"法人姓名和结算人姓名必须一致"
7.2.57 auditTime
审核时间
7.2.57.1 属性
ANS3
7.2.57.2 描述
格式 yyyyMMddHHmmss
7.2.57.3 示例
"auditTime":"20180917101010"
7.2.58 areaInfo
地区信息
7.2.58.1 属性
ANS 7
7.2.58.2 描述
用于标识交易发生地的地区信息，包括国家代码和地区代码。
位置
内容
说明
1 – 3
国家代码
参见世界各国和地区名称代码（GB/T 2659-94）。 境内机构受理的
二维码业务，国家代码固定填 156
4 – 7
地区代码
采用《银联卡跨行业务地区代码标准》，该标准每年 3 月、8 月更
新，可登录中国银联机构业务门户 （portal.unionpay.com）获取。
境外机构受理的二维码业务，地区代码固定填 0000
7.2.58.3 示例
若交易发生地为上海，本字段填写 1562900，例如： "areaInfo": "1562900"
7.2.59 backUrl
交易通知地址
7.2.59.1 属性
ANS 1..200
7.2.59.2 描述
银联云闪付合作伙伴开放平台技术指南（服务商版）
29
服务商在开通业务时应登记默认接收地址，同时可以在交易请求中重新指定新的地址，后者的
优先级高。
7.2.59.3 示例
例如：https://1.2.3.4:80/some-reference ，本字段填 写为："backUrl":
"https://1.2.3.4:80/some-reference"
7.2.60 orderType
订单类型
7.2.60.1 属性
ANS 1..32
7.2.60.2 描述
JS 支付及微信 APP 支付等场景下，服务商通过该字段指定订单类型，有如下取值：
upApp：银联 APP 支付
wechatJs:微信公众号支付
wechatH5：微信 H5 支付
wechatMiniProgram：微信小程序支付
wechatApp：微信 APP 支付
alipayJs：支付宝服务窗支付
alipayH5：支付宝 H5 支付
alipayApp：支付宝 APP 支付
根据业务开展情况，本域后续可能会新增取值。
注：银联 APP 指按照《中国银联二维码交易处理系统技术指南》接入银联开展二维码支付业务
的 APP，包括云闪付 APP、各银行 APP 等。
7.2.60.3 示例
若服务商展示的订单二维码被支付宝 APP 扫码，则服务商向银联发起的统一下单接口中订单类
型字段填写为 alipayJs，例如： "orderType": "alipayJs"
7.2.61 payData
支付数据
7.2.61.1 属性
ANS 1..512
7.2.61.2 描述
根据 orderType 返回对应的支付数据。
7.2.61.3 示例
当订单类型（orderType）为 upApp 时返回：
"payData": {
"redirectUrl": " https://qra.95516.com"
}
当订单类型（orderType）为 wechatH5 时返回：
"payData": {
银联云闪付合作伙伴开放平台技术指南（服务商版）
30
"mWebUrl":
"https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx2016121516420242
444321ca0631331346&package=1405458241"
}
当订单类型（orderType）为 wechatApp 时返回：
"payData": {
"appId": "wxd678efh567hg6787",
"partnerId": "1230000109",
"prepayId": "wx201410272009395522657a690389285100",
"package": "Sign=WxPay",
"nonceStr": "5K8264ILTKCH16CQ2502SI8ZNMTM67VS",
"timeStamp": "1414561699",
"paySign": "C380BEC2BFD727A4B6845133519F3AD6"
}
当订单类型（orderType）为 wechatJs、wechatMiniProgram 时返回：
"payData": {
"appId": "wxd678efh567hg6787",
"timeStamp": "1414561699",
"nonceStr": "5K8264ILTKCH16CQ2502SI8ZNMTM67VS",
"package": "prepay_id=123456789",
"signType": "RSA",
"paySign": "C380BEC2BFD727A4B6845133519F3AD6"
}
当订单类型（orderType）为 alipayJs、alipayH5、alipayApp 时返回：
"payData": {
"prepayId": "2018081121001004630200142207"
}
7.2.62 userId
用户标识
7.2.62.1 属性
ANS 1..128
7.2.62.2 描述
用户在 APP 上的标识号。
7.2.62.3 示例
"userId": "pF8uMuAJO_M2pxb1Q9zNjW"
7.2.63 transIndex
交易索引
7.2.63.1 属性
ANS 1..32
银联云闪付合作伙伴开放平台技术指南（服务商版）
31
7.2.63.2 描述
收单机构生成的永久唯一交易号，用于后续业务处理。
7.2.63.3 示例
"transIndex": "2018062911280008"
7.2.64 termInfo
终端信息
7.2.64.1 属性
ANS 1..300
7.2.64.2 描述
本域采用 JSON 格式，全部内容用“{ }”包含。
子域名
标识
子域格式
出现要求
描述
经度信息
longitude
ANS 1..10
O
终端的实时经度信息。 格
式：3 位整数+1 位小数点
+6 位小数， 例如
121.483527
维度信息
latitude
ANS 1..10
O
终端的实时纬度信息。 格
式：1 位正负号+2 位整数
+1 位小数点 +6 位 小
数 ， 例 如 +31.221345
或 -03.561345
终端 ip
ip
ANS 1..16
M
终端 IP
7.2.64.3 示例
"termInfo": {
"longitude": "121.483527",
"latitude": "+31.221345",
"ip": "123.12.12.123"
}
7.2.65 termId
终端号
7.2.65.1 属性
ANS 8
7.2.65.2 描述
终端号（保留字段，暂时无用）。
7.2.65.3 示例
"termId":"00000001"
银联云闪付合作伙伴开放平台技术指南（服务商版）
32
7.2.66 storeId
商户门店编号
7.2.66.1 属性
ANS 1..32
7.2.66.2 描述
商户门店编号。
7.2.66.3 示例
"storeId":"BJ00001"
7.2.67 txnAmt
交易金额
7.2.67.1 属性
N 1..12
7.2.67.2 描述
订单初始金额，不允许全 0。
在一次消费类业务的付款过程中，txnAmt 在请求和应答报文中保持一致。
7.2.67.3 示例
如订单初始金额为 100 元，本字段填写为： "txnAmt":10000
7.2.68 respMsg
应答信息
7.2.68.1 属性
ANS 1..100
7.2.68.2 描述
详见附录一。
7.2.68.3 示例
如应答码为 20 时，本字段填写值为： "respMsg": "二维码已失效"
7.2.69 respCode
应答码
7.2.69.1 属性
AN 2
7.2.69.2 描述
详见附录一。
银联云闪付合作伙伴开放平台技术指南（服务商版）
33
7.2.69.3 示例
如 20 代表二维码已失效，本字段填写值为： "respCode": "20"
7.2.70 reqReserved
服务商自定义域
7.2.70.1 属性
ANS 1..500
7.2.70.2 描述
异步保留域，供请求方透传特殊数据使用，数据格式由请求方自定义。收单机构在后续关联交
易报文中原样返回。
7.2.70.3 示例
"reqReserved":"这是异步保留数据"
7.2.71 authCode
支付条码或二维码
7.2.71.1 属性
ANS 1..32
7.2.71.2 描述
符合银联、微信或支付宝等机构标准的二维码。
银联标准：62 开头的 19 位数字；
微信标准：10~15 开头的 18 位数字；
支付宝标准：25~30 开头的 16~24 位数字。
注：本域仅在付款码支付（B 扫 C）场景中出现。
7.2.71.3 示例
"authCode": "6221234765498764569"
7.2.72 qrCode
二维码链接
7.2.72.1 属性
ANS 1..200
7.2.72.2 描述
二维码表示的数据，内容为特定格式的 URL。
7.2.72.3 示例
"qrCode": "https://qr.95516.com/00010000/281Ge139asZdfi92Mnf 2720160610150231"
银联云闪付合作伙伴开放平台技术指南（服务商版）
34
7.2.73 payTime
交易支付时间
7.2.73.1 属性
ANS 14
7.2.73.2 描述
银联处理当笔订单的时间，格式为 YYYYMMDDHHMMSS。
7.2.73.3 示例
"payTime": "20180629112830"
7.2.74 paymentValidTime
支付有效时间
7.2.74.1 属性
N 1..10
7.2.74.2 描述
允许对一个订单进行支付的最长相对时间，单位为分钟。
7.2.74.3 示例
如一笔订单必须在 10 分钟内完成支付，那么本字段填写值为： "paymentValidTime": 10
7.2.75 payerInfo
付款方信息
7.2.75.1 属性
ANS 1..1000
7.2.75.2 描述
本域采用 JSON 格式，定义如下表：
子域名
标识
子域格式
出现要求
说明
付款用户 ID
buyerId
ANS 1..100
O
付款用户账号
buyerAccount
ANS 1..100
O
支付宝才返回
7.2.75.3 示例
"payerInfo": {
"buyerId ": "18188188188",
"buyerAccount ": "18088088088"
}
7.2.76 operatorId
操作员编号
银联云闪付合作伙伴开放平台技术指南（服务商版）
35
7.2.76.1 属性
ANS 1..32
7.2.76.2 描述
操作员编号。
7.2.76.3 示例
"operatorId": " CZY00001"
7.2.77 orderInfo
订单信息
7.2.77.1 属性
ANS 1..200
7.2.77.2 描述
订单描述信息。
7.2.77.3 示例
"orderInfo": "京东生鲜食品"
7.2.78 orderNo
订单号
7.2.78.1 属性
AN 8..40
7.2.78.2 描述
交易发起方的交易主键，应保证主键唯一。
7.2.78.3 示例
"orderNo": "2018062911280001"
7.2.79 orderTime
订单时间
7.2.79.1 属性
ANS 14
7.2.79.2 描述
交易发起方生成当笔订单的时间，格式为 YYYYMMDDHHMMSS。
7.2.79.3 示例
"orderTime": "20180702142900"
银联云闪付合作伙伴开放平台技术指南（服务商版）
36
7.2.80 origOrderNo
原始订单号
7.2.80.1 属性
AN 8..40
7.2.80.2 描述
原交易的订单号。
7.2.80.3 示例
"origOrderNo": "2018062911280001"
7.2.81 origRespCode
原交易应答码
7.2.81.1 属性
AN 2
7.2.81.2 描述
同“交易应答码”。
7.2.81.3 示例
如 20 代表二维码已失效，本字段填写值为： "origRespCode": "20"
7.2.82 origRespMsg
原交易应答信息
7.2.82.1 属性
ANS 1..100
7.2.82.2 描述
同“交易应答信息”。
7.2.82.3 示例
如应答码为 20 时，本字段填写值为： "origRespMsg": "二维码已失效"
7.2.83 payAmt
买家付款金额
7.2.83.1 属性
N 1..12
7.2.83.2 描述
用户在交易中实际支付的金额。 该金额与订单初始金额（txnAmt）可以相同，也可以不同。 如
果当笔交易适配了优惠活动，报文中的 payAmt 与 txnAmt 不同，差值体现在 couponInfo 中。
银联云闪付合作伙伴开放平台技术指南（服务商版）
37
7.2.83.3 示例
如订单初始金额为 100 元（即 txnAmt=10000），交易适配了优惠活动，优惠金额 10 元，那么 买
家付款金额为 90 元（即 payAmt=9000）： "payAmt": 9000
7.2.84 settlementAmt
应结订单金额
7.2.84.1 属性
N 1..12
7.2.84.2 描述
应结算给商家的订单金额（含手续费）。
7.2.84.3 示例
"settlementAm": 800
7.2.85 limitPay
限定支付方式
7.2.85.1 属性
ANS 1..32
7.2.85.2 描述
限定对一个订单进行支付的方式。本域不出现表示不限定支付方式。
7.2.85.3 示例
如服务商指定当笔订单不允许使用信用卡支付，本字段取值为 no_credit： "limitPay":
"no_credit"
7.2.86 frontUrl
前台通知地址
7.2.86.1 属性
ANS 1..200
7.2.86.2 描述
服务商向银联下单时上送的前台通知地址（仅允许为外网地址），用户完成支付点击“返 回”
后，银联通过浏览器 POST 请求到该地址。
7.2.86.3 示例
"frontUrl": " https://www.isv001.com/pay.php "
7.2.87 currencyCode
交易币种
银联云闪付合作伙伴开放平台技术指南（服务商版）
38
7.2.87.1 属性
ANS 3
7.2.87.2 描述
交易金额对应的币种。
7.2.87.3 示例
156 代表人民币，字段填写例如： "currencyCode": "156"
7.2.88 customerIp
用户 IP
7.2.88.1 属性
NS 7..40
7.2.88.2 描述
持卡人确认付款时的 IP 地址，用于防钓鱼。
7.2.88.3 示例
"customerIp": "172.17.249.8"
7.2.89 productId
产品 IP
7.2.89.1 属性
NS 7..40
7.2.89.2 描述
销售产品 ID，对应支付宝、微信的销售产品码字段
7.2.89.3 示例
"productIp": " FAST_INSTANT_TRADE_PAY"
7.2.90 discountableAmt
可折扣金额
7.2.90.1 属性
N 1..12
7.2.90.2 描述
可打折金额，参与优惠计算的金额（支付宝特有参数）。
7.2.90.3 示例
"discountableAmt": "1000"
银联云闪付合作伙伴开放平台技术指南（服务商版）
39
8 交易报文
8.1 公共说明
8.1.1 报文结构
服务商和平台之间的报文通过 POST 方式提交，报文体里的内容即为提交的数据，
包括交易订单号、交易金额等，具体业务数据详见下文 7.2~7.9 章节。
请求报文的报文体示例如下：
{
" serProvId ": "11111111",
" merId ": "848120048712365",
" signature": "AVRSFSDFSDFSFDDFDSFDSFSDFDSFDSFDSFD",
" orderNo ": "2018062911280001",
" txnAmt ": "10000"
}
成功响应报文的报文体示例如下：
{
" respCode": "00",
" respMsg": "成功",
" signature": "AVRSFSDFSDFSFDDFDSFDSFSDFDSFDSFDSFD",
" orderNo ": "2018062911280001"
}
失败响应报文的报文体示例如下：
{
" respCode": "100",
" respMsg": "失败",
" signature": "AVRSFSDFSDFSFDDFDSFDSFSDFDSFDSFDSFD"
}
8.1.2 符号约定
表 1 符号约定
符号
含 义
M
必须填写的域
C
某条件成立时必须填写的域
O
自选填写的域
必须与先前报文中对应域的值相同
8.1.3 接口说明
接口定义中，SP 代表服务商；UP 代表平台。
银联云闪付合作伙伴开放平台技术指南（服务商版）
40
8.2 商户信息录入
8.2.1 场景说明
服务商通过调用该接口向平台报备商户信息，平台根据服务商指定的报备类型可选向微信、
支付宝等报备商户信息。
8.2.2 接口说明
接口地址：http://partner.95516.com/gateway/api/merchantRegister。
8.2.3 业务参数
名称
标识
SP
UP
备注
商户注册的名称
merchantName
M
云闪付服务商标识
serProvId
M
签名串
signature
M
M
RSA 签名串
收单机构代码
acqOrgCode
M
银联体系内分配的唯一标识
审核回调地址
backUrl
M
收单机构审核完商户资料后
的通知地址（回调服务商的地
址）
进件详细信息
paper
M
json 格式字符串
手续费扣率
rate
M
json 格式字符串
云闪付商户号
merId
C
C
接口调用成功返回。补件此字
段必传
收单机构商户号
acqMerId
C
C
接口调用成功返回。补件此字
段必传
服务商自定义域
reqReserved
O
应答码
respCode
M
响应信息
respMsg
M
服务商微信渠道号
wechatChannelId
O
收单机构系统为服务商分配
的微信渠道号
服务商支付宝渠道号
alipayChannelId
O
收单机构系统为服务商分配
的支付宝渠道号
银联云闪付合作伙伴开放平台技术指南（服务商版）
41
Paper格式如下：
（接下表）
名称
标识
SP
备注
基础信息
商户类型
merchantType
M
1：个体工商户 2：企业 3：个
人
营业执照号
businessLicenseCode
C
长度：13—18
merchantType= 1、2 必传
商户经营名称
businessLicenseName
C
注：与营业执照上登记注册的
名称一致
merchantType= 1、2 必传
营业执照照片
businessLicensePhoto
C
merchantType= 1、2 必传
营业执照有效期
businessLicenseExpired
C
merchantType= 1、2 必传
行业类目
industryCategoryId
M
位置及环境信息
经营地址
businessAddress
M
与经营地址一致
省
province
M
与经营地址一致
市
city
M
与经营地址一致
区
area
M
与经营地址一致
门店门头照
storeHeadPhoto
M
门店外景照
storeShopPhoto
M
门店内景照
storeHallPhoto
M
门店收银台照
storeCashierPhoto
M
个人资料信息 :
法人姓名
lawyerName
C
merchantType= 1、2 必传
法人证件类型
lawyerCertType
C
1：身份证；2：台胞证；3：港
澳通行证；4：其他
merchantType= 1、2 必传
法人证件号码
lawyerCertNo
C
merchantType= 1、2 必传
法人证件正面照
lawyerCertPhotoFront
C
merchantType= 1、2 必传
法人证件背面照
lawyerCertPhotoBack
O
联系人信息 :
联系人姓名
contactPerson
M
联系人手机号码
contactPhone
M
客服电话
serviceTel
M
邮箱地址
email
M
银联云闪付合作伙伴开放平台技术指南（服务商版）
42
rate格式如下：
bankCardRateLevel1
bankCardRateLevel2
结算账号信息：
结算账户类型
settleAccountType
M
1：对公账户 2：法人账户
3：被授权人账户
merchantType=3 时必填 2
结算户号
settleAccountNo
M
结算户名
settleAccount
M
结算周期
settlePeriod
M
结算周期(1：T+1；2：D+0)
开户许可证（照片）
openingLicenseAccountPho
to
C
settleAccountType=1 时必传
商户收单协议照片
acquiringAgreementPhoto
M
结算授权书（照片）
settleAuthLetterPhoto
C
settleAccountType=3 时必填
银行卡正面照
bankCardPhotoFront
C
settleAccountType=2,3 时必
传
银行卡背面照
bankCardPhotoBack
O
可选字段
开户银行
openBank
M
开户支行
openSubBank
O
开户行联行号
openBankCode
M
银行预留手机号
openBankReservePhone
M
被授权人证件号码
authorizedPersonCertNo
C
settleAccountType=3 时必填
被授权人证件类型
authorizedPersonCertType
C
1：身份证；2：台胞证；3：港
澳通行证；4：其他
settleAccountType=3 时必填
被授权人证件正面照
authorizedCertPhotoFront
C
settleAccountType=3 时必填
被授权人证件背面照
authorizedCertPhotoBack
C
settleAccountType=3 时选填
其他信息:
商户资料扩展域
reserve1
O
若收单机构需要商户其他的材
料，在扩展域中进行传送
名称
标识
SP
备注
支付宝手续费率
feeRateAlipay
O
银行卡费率一档
bankCardRateLevel1
O
交易金额大于 1000 元的费率
银行卡费率二档
bankCardRateLevel2
O
交易金额小于（含）1000 元的费率
微信手续费率
feeRateWechatpay
O
银联手续费率(借记)
feeRateUnionpayDebit
O
银联手续费率(借记封顶)
feeRateUnionpayDebitCap
O
传 0 表示不封顶
银联手续费率(贷记)
feeRateUnionpayCredit
O
银联云闪付合作伙伴开放平台技术指南（服务商版）
43
8.3 商户信息修改
8.3.1 场景说明
服务商通过调用该接口修改商户信息,修改商户信息时基础信息不可修改。
只能修改对私结算。且结算账户类型、收款人个人信息不能修改。
8.3.2 接口说明
接口地址： http://partner.95516.com/gateway/api/merchantModify。
8.3.3 业务参数
名称
标识
SP
UP
备注
云闪付商户号
merId
M
云闪付服务商标
识
serProvId
M
签名串
signature
M
M
RSA 签名串
进件详细信息
paper
O
参数入件申请
手续费扣率
rate
O
json 格式字符串
应答码
respCode
M
响应信息
respMsg
M
Paper格式如下：
rate格式如下：
bankCardRateLevel1
银联手续费率(借记)
feeRateUnionpayDebit
O
银联手续费率(借记封顶)
feeRateUnionpayDebitCap
O
传 0 表示不封顶
银联手续费率(贷记)
feeRateUnionpayCredit
O
名称
标识
SP
备注
结算户号
settleAccountNo
M
银行卡正面照
bankCardPhotoFront
M
银行卡背面照
bankCardPhotoBack
O
可不传
开户银行
openBank
M
开户支行
openSubBank
O
开户行联行号
openBankCode
M
银行预留手机号
openBankReservePhone
M
名称
标识
SP
备注
支付宝手续费率
feeRateAlipay
O
银行卡费率一档
bankCardRateLevel1
O
交易金额大于 1000 元的费率
银行卡费率二档
bankCardRateLevel2
O
交易金额小于（含）1000 元的费率
微信手续费率
feeRateWechatpay
O
银联云闪付合作伙伴开放平台技术指南（服务商版）
44
bankCardRateLevel2
8.4 商户信息查询
8.4.1 场景说明
服务商通过调用该接口向平台查询报备的商户信息。
8.4.2 接口说明
接口地址：http://partner.95516.com/gateway/api/merchantQuery。
8.4.3 业务参数
名称
标识
SP
UP
备注
云闪付商户号
merId
M
M
云闪付服务商标识
serProvId
M
签名串
signature
M
M
RSA 签名串
应答码
respCode
M
响应信息
respMsg
M
审核状态
auditStatus
M
1：待审核 2：已完成 3：审
核失败
审核说明
auditMsg
M
审核时间
auditTime
O
yyyyMMddHHmmss
auditStatus=2,3 必定存在
商户详细信息
paper
M
json 格式字符串
手续费扣率
rate
M
json 格式字符串
Paper格式如下（去掉进件资料中图片后的全部信息）：
rate格式如下：
银联手续费率(借记)
feeRateUnionpayDebit
O
银联手续费率(借记封顶)
feeRateUnionpayDebitCap
O
传 0 表示不封顶
银联手续费率(贷记)
feeRateUnionpayCredit
O
银联手续费率(借记)
feeRateUnionpayDebit
O
银联手续费率(借记封顶)
feeRateUnionpayDebitCap
O
传 0 表示不封顶
银联手续费率(贷记)
feeRateUnionpayCredit
O
名称
标识
SP
备注
商户注册的名称
merchantName
M
结算账户类型
settleAccountType
M
1：对公账户 2：法人账户 3：被
授权人账户
结算户号
settleAccountNo
M
结算户名
settleAccount
M
结算周期
settlePeriod
M
结算周期(1：T+1；2：D+0)
银联云闪付合作伙伴开放平台技术指南（服务商版）
45
bankCardRateLevel1
bankCardRateLevel2
8.5 商户进件通知异步回调
8.5.1 场景说明
收单机构在商户进件成功后通知异步通知服务商系统商户进件的结果。
8.5.2 接口说明
接口地址：服务商进件请求时传入的地址。
8.5.3 业务参数
名称
标识
SP
UP
备注
云闪付服务商标
识
serProvId
M
签名串
signature
M
M
RSA 签名串
云闪付商户号
merId
M
收单机构商户号
acqMerId
M
收单机构生成的商户号
审核状态
auditStatus
M
1：待审核 2：已完成 3：审
核失败
审核失败原因
auditMsg
C
auditStatus=3 时必传
返回参数：success 表示成功，其他表示失败
8.6 微信参数配置-支付授权目录
8.6.1 场景说明
名称
标识
SP
备注
支付宝手续费率
feeRateAlipay
O
银行卡费率一档
bankCardRateLevel1
O
交易金额大于 1000 元的费率
银行卡费率二档
bankCardRateLevel2
O
交易金额小于（含）1000 元的费率
微信手续费率
feeRateWechatpay
O
银联手续费率(借记)
feeRateUnionpayDebit
O
银联手续费率(借记封顶)
feeRateUnionpayDebitCap
O
银联手续费率(贷记)
feeRateUnionpayCredit
O
银联手续费率(借记)
feeRateUnionpayDebit
O
银联手续费率(借记封顶)
feeRateUnionpayDebitCap
O
银联手续费率(贷记)
feeRateUnionpayCredit
O
银联云闪付合作伙伴开放平台技术指南（服务商版）
46
8.6.2 接口说明
接口地址：http://partner.95516.com/gateway/api/wechatConfig/jsapiPath
8.6.3 业务参数
名称
标识
SP
UP
备注
云闪付商户号
merId
M
M
云闪付服务商标
识
serProvId
M
签名串
signature
M
M
RSA 签名串
支付授权目录
jsapiPath
M
子商户公众账号 JS API 支付授权
目录
应答码
respCode
M
响应信息
respMsg
M
8.7 微信参数配置-子商户 appId
8.7.1 场景说明
8.7.2 接口说明
接口地址：http://partner.95516.com/gateway/api/wechatConfig/subAppid
8.7.3 业务参数
名称
标识
SP
UP
备注
云闪付商户号
merId
M
M
云闪付服务商标
识
serProvId
M
签名串
signature
M
M
RSA 签名串
子商户 SubAPPID
subAppid
M
子商户 SubAPPID
应答码
respCode
M
响应信息
respMsg
M
8.8 微信参数配置-推荐关注 appid
8.8.1 场景说明
8.8.2 接口说明
接口地址：http://partner.95516.com/gateway/api/wechatConfig/subscribeAppid
8.8.3 业务参数
名称
标识
SP
UP
备注
云闪付商户号
merId
M
M
云闪付服务商标
识
serProvId
M
银联云闪付合作伙伴开放平台技术指南（服务商版）
47
签名串
signature
M
M
RSA 签名串
子商户 SubAPPID
subAppid
M
子商户 SubAPPID
推荐关注 APPID
subscribeAppid
M
子商户推荐关注公众账号 APPID
应答码
respCode
M
响应信息
respMsg
M
8.9 图片上传
8.9.1 场景说明
8.9.2 接口说明
接口地址：http://partner.95516.com/gateway/api/imageUpload。
请求方式：POST multipart/form-data 方式
8.9.3 业务参数
名称
标识
SP
UP
备注
图片文件
uploadFile
M
不参与签名
云闪付服务商标
识
serProvId
M
签名串
signature
M
M
RSA 签名串
应答码
respCode
M
响应信息
respMsg
M
图片相对路径
uri
M
8.10 统一下单支付
8.10.1 场景说明
除付款码支付、扫码支付场景以外，商户系统先调用该接口在平台生成预支付交易单，返回正
确的预支付交易会话标识后再按 JSAPI、APP 等不同场景生成交易串调起支付。
8.10.2 接口说明
接口地址：http://partner.95516.com/gateway/api/pay/unifiedorder
8.10.3 业务参数
名称
标识
SP
UP
备注
云闪付服务商
标识
serProvId
M
签名串
signature
M
M
RSA 签名串
云闪付商户号
merId
M
终端号
termId
O
银联云闪付合作伙伴开放平台技术指南（服务商版）
48
订单类型
orderType
M
订单类型
upApp：银联 APP 支付
wechatJs：微信公众号支付
wechatH5：微信 H5 支付
wechatApp：微信 APP 支付
wechatMiniProgram：微信小程序支付
alipayJs：支付宝服务窗支付
alipayH5：支付宝 H5 支付
alipayApp：支付宝 APP 支付
订单号
orderNo
M
发送方交易主键，需保证唯一
订单时间
orderTime
O
如：20180702142900
支付有效时间
paymentValidTime
O
支付有效时间，单位：分钟
限制支付
limitPay
O
no_credit：指定不能使用信用卡支
付
交易金额
txnAmt
M
单位：分，不带小数点
交易币种
currencyCode
O
不出现则默认为人民币-156
订单信息
orderInfo
M
订单描述信息，如：京东生鲜食品
终端信息
termInfo
O
终端 IP、经纬度等信息，JSON 格式，
如：
“termInfo":{
"longitude":"121.483527",
"latitude":"31.221345",
"ip": "123.12.12.123"
}
地区信息
areaInfo
O
门店所属城市
商品详情
goodsInfo
O
JSON 格式，如微信单品优惠，云闪付
平台只做透传
商品标记
goodsTag
O
订单优惠标记，代金券或立减优惠功
能的参数
产品 ID
productId
O
微信、支付宝直接使用
可打折金额
discountableAmt
O
支付宝特有参数，参与优惠计算的金
额。单位：分
服务商自定义
域
reqReserved
O
后台通知地址
backUrl
M
前台通知地址
frontUrl
O
用户 IP
customerIp
M
用户标识
userId
M
用户标识
支付宝服务窗为用户的 buyer_id
微信公众号为用户的 openid
子商户公众号
id
subAppId
O
子商户公众号 id,微信交易为商户的
appid
场景信息
sceneInfo
O
微信 H5 支付必传。
//IOS 移动应用
{"h5_info":
{"type":"IOS","app_name": " 王者
荣耀","bundle_id":
"com.tencent.wzryIOS"}}
//安卓移动应用
银联云闪付合作伙伴开放平台技术指南（服务商版）
49
{"h5_info":
{"type":"Android","app_name": "
王者荣耀","package_name":
"com.tencent.tmgp.sgame"}}
//WAP 网站应用
{"h5_info":
{"type":"Wap","wap_url":
"https://pay.qq.com","wap_name":
"腾讯充值"}}
应答码
respCode
M
响应信息
respMsg
M
支付数据
payData
C
成功时返回。根据 orderType 返回相
应的支付数据
8.11 扫码支付
8.11.1 场景说明
扫码支付（用户扫描商户二维码）场景中，服务商通过调用该接口获取二维码并展示出来。
8.11.2 接口说明
接口地址：http://partner.95516.com/gateway/api/pay/qrpay
8.11.3 业务参数
名称
标识
SP
UP
备注
云闪付服务商标
识
serProvId
M
签名串
signature
M
M
RSA 签名串
云闪付商户号
merId
M
终端号
termId
O
订单类型
orderType
M
订单类型
alipay-支付宝
wechat-微信支付
unionpay-银联二维码
订单号
orderNo
M
发送方交易主键，需保证唯一
订单时间
orderTime
O
如：20180702142900
支付有效时间
paymentValidTime
O
支付有效时间，单位：分钟
限制支付
limitPay
O
no_credit：指定不能使用信用
卡支付
交易金额
txnAmt
M
单位：分，不带小数点
交易币种
currencyCode
O
不出现则默认为人民币-156
订单信息
orderInfo
M
订单描述信息，如：京东生鲜食
品
终端信息
termInfo
M
终端 IP、经纬度等信息，JSON
格式，如：
“termInfo":{
银联云闪付合作伙伴开放平台技术指南（服务商版）
50
"longitude":"121.483527",
"latitude":"31.221345",
"ip": "123.12.12.123"
}
地区信息
areaInfo
O
门店所属城市
商户门店编号
storeId
O
商户操作员编号
operatorId
O
商品详情
goodsInfo
O
JSON 格式，如微信单品优惠，云
闪付平台只做透传
商品标记
goodsTag
O
订单优惠标记，代金券或立减优
惠功能的参数
产品 ID
productId
O
微信、支付宝直接使用
可打折金额
discountableAmt
O
支付宝特有参数，参与优惠计算
的金额。单位：分
服务商自定义域
reqReserved
O
交易通知地址
backUrl
M
支付结果将送到本地址
应答码
respCode
M
响应信息
respMsg
M
二维码
qrCode
C
成功时返回
8.12 付款码支付
8.12.1 场景说明
收银员使用扫码设备读取用户 APP 展示的二维码后，通过后台系统调用该接口发起支付。
当合作伙伴平台返回支付中或交易状态不明时，服务商需要调用交易查询接口查询订单实际支
付状态。建议间隔 5 秒调一次查询，调用 6 次后还未成功作支付超时处理。
8.12.2 接口说明
接口地址：http://partner.95516.com/gateway/api/pay/micropay
8.12.3 业务参数
名称
标识
SP
UP
备注
云闪付服务商标
识
serProvId
M
签名串
signature
M
M
RSA 签名串
云闪付商户号
merId
M
终端号
termId
O
付款码
authCode
M
用户 APP 展示的付款条码或二维
码
订单类型
orderType
M
订单类型
alipay-支付宝
wechat-微信支付
unionpay-银联二维码
订单号
orderNo
M
C
成功时返回。发送方交易主键，
需保证唯一
订单时间
orderTime
O
如：20180702142900
银联云闪付合作伙伴开放平台技术指南（服务商版）
51
支付有效时间
paymentValidTime
O
支付有效时间，单位：分钟
限制支付
limitPay
O
no_credit：指定不能使用信用
卡支付
交易金额
txnAmt
M
C
成功时返回。单位：分，不带小
数点
交易币种
currencyCode
O
不出现则默认为人民币-156
订单信息
orderInfo
M
订单描述信息，如：京东生鲜食
品
终端信息
termInfo
M
终端 IP、经纬度等信息，JSON
格式，如：
“termInfo":{
"longitude":"121.483527",
"latitude":"31.221345",
"ip": "123.12.12.123"
}
地区信息
areaInfo
O
门店所属城市
商品详情
goodsInfo
O
JSON 格式，如微信单品优惠，云
闪付平台只做透传
商品标记
goodsTag
O
订单优惠标记，代金券或立减优
惠功能的参数
产品 ID
productId
O
微信、支付宝直接使用
可打折金额
discountableAmt
O
支付宝特有参数，参与优惠计算
的金额。单位：分
商户门店编号
storeId
O
商户操作员编号
operatorId
O
应答码
respCode
M
响应信息
respMsg
M
交易索引
transIndex
C
成功时出现
付款方信息
payerInfo
C
成功时出现
优惠信息
couponInfo
C
成功时出现。使用优惠活动时出
现
单品优惠信息
dctGoodsInfo
O
成功时出现。单品优惠详情
买家付款金额
payAmt
C
成功时出现。单位：分，不带小
数点
应结订单金额
settlementAmt
C
成功时出现
交易支付时间
payTime
C
成功时出现。如：20180629112830
8.13 撤销订单
8.13.1 场景说明
当收银系统超时需要取消交易，可以调用该接口。 注意：正常支付的订单如需实现相同功能
请调用退款接口。 调用支付接口后请勿立即调用撤销订单接口，建议支付后至少 15s 后再调
用撤销订单接口。
注：该接口只适用于付款码支付场景。
8.13.2 接口说明
接口地址：http://partner.95516.com/gateway/api/pay/cancelOrder
银联云闪付合作伙伴开放平台技术指南（服务商版）
52
8.13.3 业务参数
名称
标识
SP
UP
备注
云闪付服务商标
识
serProvId
M
签名串
signature
M
M
RSA 签名串
云闪付商户号
merId
M
原订单号
origOrderNo
M
同原 C2B 消费交易订单号
撤销订单号
orderNo
M
订单类型
orderType
M
订单类型
alipay-支付宝(付款码支付)
wechat-微信支付(付款码支付)
unionpay-银联二维码(付款码支付)
应答码
respCode
M
响应信息
respMsg
M
交易索引
transIndex
C
成功时返回。代表撤销流水号
8.14 关闭订单
8.14.1 场景说明
以下两种情况需要调用关闭订单接口：商户订单支付失败需要生成新订单发起支付，此时 需
要关闭原订单，避免用户重复支付；服务商下单后用户支付超时，服务商系统退出不再受理，
避免用户继续支付，需要调用关单接口。
8.14.2 接口说明
接口地址：http://partner.95516.com/gateway/api/pay/closeOrder
8.14.3 业务参数
名称
标识
SP
UP
备注
云闪付服务商标
识
serProvId
M
签名串
signature
M
M
RSA 签名串
云闪付商户号
merId
M
订单号
orderNo
M
订单类型
orderType
M
订单类型
alipay-支付宝（扫码支付，服务窗）
wechat-微信支付（扫码支付、公众
号、小程序、app 支付、H5 支付）
unionpay-银联二维码(扫码支付)
应答码
respCode
M
响应信息
respMsg
M
银联云闪付合作伙伴开放平台技术指南（服务商版）
53
8.15 查询订单
8.15.1 场景说明
根据订单号或者交易索引查询具体订单信息。调用订单查询接口建议：查询 6 次每隔 5 秒查 询
一次（具体的查询次数和时间也可自定义，建议查询时间不低于 30 秒）。6 次查询完成，接口
仍未返回成功标识则调用撤销接口。
8.15.2 接口说明
接口地址：http://partner.95516.com/gateway/api/pay/queryOrder
8.15.3 业务参数
名称
标识
SP
UP
备注
云闪付服务商标
识
serProvId
M
签名串
signature
M
M
RSA 签名串
云闪付商户号
merId
M
订单号
orderNo
M
C
原交易应答码为 00 时返回
订单类型
orderType
M
订单类型
alipay-支付宝
wechat-微信支付
unionpay-银联二维码
应答码
respCode
M
响应信息
respMsg
M
原交易应答码
origRespCode
C
当应答码 respMsg 为 00 时返
回，代表被查询交易的状态
00- 支付成功
01- 转入退款
02- 未支付
03- 已关闭
04- 已撤销(刷卡支付)
05- 用户支付中
06- 支付失败
原交易响应信息
origRespMsg
C
同上
交易索引
transIndex
C
原交易应答码为 00 时返回
付款方信息
payerInfo
C
原交易应答码为 00 时返回
交易金额
txnAmt
C
原交易应答码为 00 时返回
优惠信息
couponInfo
C
原交易应答码为 00 时返回
买家付款金额
payAmt
C
原交易应答码为 00 时返回
应结订单金额
settlementAmt
C
原交易应答码为 00 时返回
交易支付时间
payTime
C
原交易应答码为 00 时返回
单品优惠信息
dctGoodsInfo
C
原交易应答码为 00 时返回
服务商自定义域
reqReserved
C
原交易应答码为 00 时返回
银联云闪付合作伙伴开放平台技术指南（服务商版）
54
8.16 申请退款
8.16.1 场景说明
服务商针对某一个已经成功支付的订单发起退款。同一笔单的部分退款需要设置相同的原始交
易订单号（origOrderNo）和不同的订单号（orderNo）。一笔退款失败后重新提交，要采 用原
来的 orderNo。 总退款金额不能超过用户实际支付金额。
8.16.2 接口说明
接口地址：http://partner.95516.com/gateway/api/pay/refund
8.16.3 业务参数
名称
标识
SP
UP
备注
云闪付服务商标
识
serProvId
M
签名串
signature
M
M
RSA 签名串
云闪付商户号
merId
M
原订单号
origOrderNo
M
原交易的订单号
原交易金额
origTxnAmt
M
原交易的总金额
退款订单号
orderNo
M
本次退货交易的订单号
退款金额
txnAmt
M
本次退货的金额
订单类型
orderType
M
订单类型
alipay-支付宝
wechat-微信支付
unionpay-银联二维码
应答码
respCode
M
响应信息
respMsg
M
8.17 退款查询
8.17.1 场景说明
提交退款申请后，通过调用该接口查询退款状态。
8.17.2 接口说明
接口地址：http://partner.95516.com/gateway/api/pay/refundQuery
8.17.3 业务参数
名称
标识
SP
UP
备注
云闪付服务商标
识
serProvId
M
签名串
signature
M
M
RSA 签名串
云闪付商户号
merId
M
退款订单号
orderNo
M
C
应答码为 00 时返回。同退款交
易的订单号
银联云闪付合作伙伴开放平台技术指南（服务商版）
55
应答码
respCode
M
响应信息
respMsg
M
原交易应答码
origRespCode
C
当应答码 respCode 为 00 时返
回，代表退货交易的状态
00- 退款成功
01- 退款失败
02- 退款处理中
原交易响应信息
origRespMsg
C
同上
交易索引
transIndex
C
应答码为 00 时返回，代表收单
机构退款流水号
退款金额
txnAmt
C
退货的金额
原订单号
origOrderNo
C
原交易的订单号
8.18 支付通知
8.18.1 场景说明
扫码支付（用户扫描商户二维码）、统一下单支付场景下，用户支付成功后，合作伙伴平台通过
调用该接口将支付结果通知服务商。
8.18.2 接口说明
接口地址： 统一下单支付或扫码支付接口中的 backUrl 地址。
8.18.3 业务参数
名称
标识
SP
UP
备注
签名串
signature
M
RSA 签名串
订单号
orderNo
M
交易金额
txnAmt
M
交易币种
currencyCode
M
交易索引
transIndex
M
付款方信息
payerInfo
M
买家付款金额
payAmt
M
应结订单金额
settlementAmt
M
交易支付时间
payTime
M
优惠信息
couponInfo
C
单品优惠信息
dctGoodsInfo
C
服务商自定义域
reqReserved
C
返回参数：success 表示成功，其他表示失败
附录一 入件报文应答码
应答码
描述
00
成功
01
云闪付内部数据处理异常
02
解析收单方报文错误
银联云闪付合作伙伴开放平台技术指南（服务商版）
56
03
请求收单方网络超时
10
获取商户号失败
11
服务商 ID 未注册
12
加密失败
13
解密失败
14
验签失败
15
商户注册名称已存在
16
结算户名与法人信息不匹配
17
结算银行信息不正确
18
法人信息不正确
19
支付宝费率不正确
20
微信费率不正确
21
银联二维码费率不正确
22
参数 xx 格式不正确
23
缺少必填参数 xx
99
其他
附录二 交易报文应答码
应答码
描述
00
成功
01
系统错误，交易失败
02
用户支付中，请稍后查询
03
交易已退款
04
交易状态未明
05
交易已被支付
06
系统繁忙，请稍后再试
07
交易已经关闭
08
无效金额
09
商户备注已存在，请修改后重新提交
10
报文格式错误
11
验证签名失败
12
重复交易
13
报文交易要素缺失
14
交易已撤销
15
余额不足
16
订单号重复
17
交易不存在
20
二维码已失效
21
支付次数超限
22
二维码状态错误
23
无此二维码
31
商户或机构状态不正确
32
无此交易权限
33
交易金额超限
35
原交易不存在或状态不正确
36
与原交易信息不符
37
已超过最大查询次数或操作过于频繁
38
基于风险控制原因失败
银联云闪付合作伙伴开放平台技术指南（服务商版）
57
39
交易不在受理时间范围内

云闪付合作伙伴开放平台 | Copyright © 2018