中国银联开放平台

文档中心

接口列表

二维码支付

交易状态查询接口

申请二维码（主扫）

申请预授权二维码（主扫）

统一下单（主扫）

申请缴费二维码

二维码预授权（被扫）

二维码消费（被扫）

退货类（退货）

退货类（消费撤销类）

冲正

预授权完成

预授权撤销

预授权完成撤销

文件传输类交易接口

申请NFC标签数据

二维码支付

查看产品

更新时间：2022-08-09

预授权完成撤销

接口描述

预授权完成撤销交易必须是对原始预授权完成交易的全额撤销。预授权完成撤销后的预授权仍然有效。

请求方式

POST

生产调用地址

https://gateway.95516.com/gateway/api/backTransReq.do

测试调用地址

https://101.231.204.80:5000/gateway/api/backTransReq.do

请求参数

中文名称	英文名称	域类型	默认值	请求要求	备注
版本号	version	NS5	无	M-必填	固定填写
编码方式	encoding	ANS1..20	UTF-8	M-必填	默认取值：UTF-8
产品类型	bizType	N6	无	M-必填	000201
订单发送时间	txnTime	YYYYMMDDhhmmss	无	M-必填
后台通知地址	backUrl	ANS1..256	无	M-必填	后台返回商户结果时使用，如上送，则发送商户后台交易结果通知，如需通过专线通知，需要在通知地址前面加上前缀：专线的首字母加竖线ZX\|
交易金额	txnAmt	N1..12	无	M-必填	与原始预授权完成交易一致
交易类型	txnType	N2	无	M-必填	取值：33
交易子类	txnSubType	N2	无	M-必填	默认：00
接入类型	accessType	N1	无	M-必填	0：普通商户直连接入 2：平台类商户接入
签名	signature	ANS1..1024	0	M-必填	填写对报文摘要的签名
签名方法	signMethod	N2	无	M-必填	非对称签名： 01（表示采用RSA签名） HASH表示散列算法 11：支持散列方式验证SHA-256 12：支持散列方式验证SM3
渠道类型	channelType	N2	无	M-必填
商户代码	merId	AN15	无	M-必填
商户订单号	orderId	AN8..40	无	M-必填	预授权完成撤销的订单号，由商户生成
证书ID	certId	N1..128	无	M-必填
二级商户代码	subMerId	AN5..15	无	C-按条件必填	商户类型为平台类商户接入时必须上送
二级商户简称	subMerAbbr	ANS1…16	无	C-按条件必填	商户类型为平台类商户接入时必须上送
二级商户名称	subMerName	ANS1..40	无	C-按条件必填	商户类型为平台类商户接入时必须上送
接入机构代码	accInsCode	AN8..11	无	C-按条件必填	接入机构代码时出现
原交易查询流水号	origQryId	AN21	无	C-按条件必填	1. 同预授权交易的queryId； 2.origQryId、origOrderId + origTxnTime二者必送其一
原交易商户订单号	origOrderId	AN8..40	无	C-按条件必填	1.原始预授权交易的orderId； 2.origQryId、origOrderId + origTxnTime二者必送其一
原交易商户发送交易时间	origTxnTime	YYYYMMDDhhmmss	无	C-按条件必填	1.原始预授权交易的txnTime； 2.origQryId、origOrderId + origTxnTime二者必送其一
保留域	reserved	ANS1..2048	无	O-选填	查看详情
请求方保留域	reqReserved	ANS1..1024	无	O-选填	商户自定义保留域，交易应答时会原样返回
终端号	termId	ANS8	无	O-选填

应答报文（同步应答）

中文名称	英文名称	域类型	默认值	请求要求	备注
查询流水号	queryId	AN20..21	无	M-必填	预授权完成撤销交易的交易流水号，供查询用
签名	signature	ANS1..1024	0	M-必填
签名方法	signMethod	N2	无	M-必填
应答码	respCode	AN2	无	M-必填
应答信息	respMsg	ANS1..256	无	M-必填
接入机构代码	accInsCode	AN8..11	无	C-按条件必填	接入机构代码时出现
签名公钥证书	signPubKeyCert	AN2048	无	C-按条件必填	使用RSA签名方式时必选，此域填写银联签名公钥证书。
版本号	version	NS5	无	R-需要返回
编码方式	encoding	ANS1..20	UTF-8	R-需要返回
产品类型	bizType	N6	无	R-需要返回
订单发送时间	txnTime	YYYYMMDDhhmmss	无	R-需要返回
交易金额	txnAmt	N1..12	无	R-需要返回
交易类型	txnType	N2	无	R-需要返回
交易子类	txnSubType	N2	无	R-需要返回
接入类型	accessType	N1	无	R-需要返回
请求方保留域	reqReserved	ANS1..1024	无	R-需要返回
商户代码	merId	AN15	无	R-需要返回
商户订单号	orderId	AN8..40	无	R-需要返回
原交易查询流水号	origQryId	AN21	无	R-需要返回	原始预授权完成交易的queryId
保留域	reserved	ANS1..2048	无	O-选填	查看详情

后台通知参数（异步应答）

中文名称	英文名称	域类型	默认值	请求要求	备注
查询流水号	queryId	AN20..21	无	M-必填	预授权完成撤销交易的交易流水号，供查询用
交易币种	currencyCode	AN3	无	M-必填
交易传输时间	traceTime	MMDDhhmmss	无	M-必填
签名	signature	ANS1..1024	0	M-必填
签名方法	signMethod	N2	无	M-必填
清算币种	settleCurrencyCode	AN3	无	M-必填
清算金额	settleAmt	N1..12	无	M-必填
清算日期	settleDate	MMDD	无	M-必填
系统跟踪号	traceNo	N6	无	M-必填
应答码	respCode	AN2	无	M-必填
应答信息	respMsg	ANS1..256	无	M-必填
兑换日期	exchangeDate	MMDD	无	C-按条件必填	交易成功，交易币种和清算币种不一致的时候返回
接入机构代码	accInsCode	AN8..11	无	C-按条件必填	接入机构代码时出现
签名公钥证书	signPubKeyCert	AN2048	无	C-按条件必填	使用RSA签名方式时必选，此域填写银联签名公钥证书。
清算汇率	exchangeRate	N8	无	C-按条件必填	交易成功，交易币种和清算币种不一致的时候返回
版本号	version	NS5	无	R-需要返回
编码方式	encoding	ANS1..20	UTF-8	R-需要返回
产品类型	bizType	N6	无	R-需要返回
订单发送时间	txnTime	YYYYMMDDhhmmss	无	R-需要返回
交易金额	txnAmt	N1..12	无	R-需要返回
交易类型	txnType	N2	无	R-需要返回
交易子类	txnSubType	N2	无	R-需要返回
接入类型	accessType	N1	无	R-需要返回
请求方保留域	reqReserved	ANS1..1024	无	R-需要返回
商户代码	merId	AN15	无	R-需要返回
商户订单号	orderId	AN8..40	无	R-需要返回
原交易查询流水号	origQryId	AN21	无	R-需要返回	原始预授权完成交易的queryId
保留域	reserved	ANS1..2048	无	O-选填	查看详情

异常应答说明

1. 不返回报文体的情况：
版本号，交易类型、子类，签名方法，签名值等关键域未上送，返回“Invalid request.”；
交易类型和请求地址校验有误，返回“Invalid request URI.”

2. 返回全部的请求报文，附加应答码和应答描述（包括的应答码有：01、02、03、10、11、32）：
验证签名失败；
报文格式错（包含，必填域缺失，上送银联报文未定义的域，报文域的格式非法，交易时间超出范围）；
签名失败；
超时等其他系统异常

提示信息

提示