二维码支付
查看产品
更新时间: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):
验证签名失败;
报文格式错(包含,必填域缺失,上送银联报文未定义的域,报文域的格式非法,交易时间超出范围);
签名失败;
超时等其他系统异常