接口描述
因人为原因而撤销已完成的消费，商户可以通过SDK向银联全渠道支付平台发起消费撤销交易，消费撤销必须是撤销CUPS当日当批的消费。发卡行批准的消费撤销金额将即时地反映到该持卡人的账户上。完成交易的过程不需要同持卡人交互，属于后台交易。
请求方式
POST
生产调用地址
https://gateway.95516.com/gateway/api/backTransReq.do
测试调用地址
https://gateway.test.95516.com/gateway/api/backTransReq.do
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | 5.1.0 | M-必填 | 固定填写
|
||
| 编码方式 | encoding | string | UTF-8 | M-必填 | 默认取值：UTF-8
|
||
| 证书ID | certId | string | C-按条件必填 |
|
|||
| 签名 | signature | string | M-必填 | 填写对报文摘要的签名
|
|||
| 签名方法 | signMethod | string | M-必填 | 非对称签名：01（表示采用RSA签名）
HASH表示散列算法
11：支持散列方式验证SHA-256
12：支持散列方式验证SM3
|
|||
| 交易类型 | txnType | string | 31 | M-必填 | 取值：31
|
||
| 交易子类 | txnSubType | string | 00 | M-必填 | 默认:00
|
||
| 产品类型 | bizType | string | M-必填 |
|
|||
| 渠道类型 | channelType | string | M-必填 |
|
|||
| 后台通知地址 | backUrl | string | M-必填 | 前台返回商户结果时使用，前台类交易需上送
|
|||
| 接入类型 | accessType | string | M-必填 | 后台返回商户结果时使用，如上送，则发送商户后台交易结果通知，如需通过专线通知，需要在通知地址前面加上前缀：专线的首字母加竖线ZX|
|
|||
| 收单机构代码 | acqInsCode | string | C-按条件必填 | 0：普通商户直连接入
1：收单机构接入
2：平台类商户接入
|
|||
| 商户类别 | merCatCode | string | C-按条件必填 | 接入类型为收单机构接入时需上送
|
|||
| 商户代码 | merId | string | M-必填 | 接入类型为收单机构接入时需上送
|
|||
| 商户名称 | merName | string | C-按条件必填 |
|
|||
| 商户英文名称 | merEnName | string | C-按条件必填 | 接入类型为收单机构接入时需上送
|
|||
| 商户简称 | merAbbr | string | C-按条件必填 | 接入类型为收单机构接入时需上送
|
|||
| 二级商户代码 | subMerId | string | C-按条件必填 | 接入类型为收单机构接入时需上送
|
|||
| 二级商户全称 | subMerName | string | C-按条件必填 | 商户类型为平台类商户接入时必须上送
|
|||
| 二级商户简称 | subMerAbbr | string | C-按条件必填 | 商户类型为平台类商户接入时必须上送
|
|||
| 商户订单号 | orderId | string | M-必填 | 商户类型为平台类商户接入时必须上送
|
|||
| 原始交易流水号 | origQryId | string | M-必填 | 消费撤销的订单号，由商户生成
|
|||
| 订单发送时间 | txnTime | string | M-必填 | 原始消费交易的queryId
|
|||
| 交易金额 | txnAmt | string | M-必填 |
|
|||
| 终端号 | termId | string | O-选填 | 与原始消费交易一致
|
|||
| 请求方保留域 | reqReserved | string | O-选填 |
|
|||
| 保留域 | reserved | string | O-选填 | 商户自定义保留域，交易应答时会原样返回
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | R-需要返回 |
|
|||
| 编码方式 | encoding | string | R-需要返回 |
|
|||
| 签名 | signature | string | M-必填 |
|
|||
| 签名方法 | signMethod | string | M-必填 |
|
|||
| 交易类型 | txnType | string | R-需要返回 |
|
|||
| 交易子类 | txnSubType | string | R-需要返回 |
|
|||
| 产品类型 | bizType | string | R-需要返回 |
|
|||
| 接入类型 | accessType | string | R-需要返回 |
|
|||
| 收单机构代码 | acqInsCode | string | C-按条件必填 |
|
|||
| 商户代码 | merId | string | R-需要返回 |
|
|||
| 商户订单号 | orderId | string | R-需要返回 |
|
|||
| 原始交易流水号 | origQryId | string | R-需要返回 | 原始消费交易的queryId
|
|||
| 订单发送时间 | txnTime | string | R-需要返回 |
|
|||
| 交易金额 | txnAmt | string | R-需要返回 |
|
|||
| 请求方保留域 | reqReserved | string | R-需要返回 |
|
|||
| 保留域 | reserved | string | O-选填 |
|
|||
| 银联交易流水号 | queryId | string | M-必填 | 退货交易的交易流水号 供查询用
|
|||
| 响应码 | respCode | string | M-必填 |
|
|||
| 应答信息 | respMsg | string | M-必填 |
|
|||
| 签名公钥证书 | signPubKeyCert | string | C-按条件必填 | 此域填写银联签名公钥证书，使用RSA签名方式时，默认返回，如果ctrlRule第五位为1时，不返。
|
异步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | R-需要返回 | ||||
| 编码方式 | encoding | string | R-需要返回 | ||||
| 签名 | signature | string | M-必填 | ||||
| 签名方法 | signMethod | string | M-必填 | ||||
| 交易类型 | txnType | string | R-需要返回 | ||||
| 交易子类 | txnSubType | string | R-需要返回 | ||||
| 产品类型 | bizType | string | R-需要返回 | ||||
| 接入类型 | accessType | string | R-需要返回 | ||||
| 收单机构代码 | acqInsCode | string | C-按条件必填 | ||||
| 商户代码 | merId | string | R-需要返回 | ||||
| 商户订单号 | orderId | string | R-需要返回 | ||||
| 原始交易流水号 | origQryId | string | R-需要返回 | 原始消费交易的queryId | |||
| 订单发送时间 | txnTime | string | R-需要返回 | ||||
| 交易币种 | currencyCode | string | M-必填 | ||||
| 交易金额 | txnAmt | string | R-需要返回 | ||||
| 请求方保留域 | reqReserved | string | R-需要返回 | ||||
| 保留域 | reserved | string | O-选填 | ||||
| 银联交易流水号 | queryId | string | M-必填 | 退货交易的交易流水号 供查询用 | |||
| 响应码 | respCode | string | M-必填 | ||||
| 响应信息 | respMsg | string | M-必填 | ||||
| 清算金额 | settleAmt | string | M-必填 | ||||
| 清算币种 | settleCurrencyCode | string | M-必填 | ||||
| 清算日期 | settleDate | string | M-必填 | ||||
| 系统跟踪号 | traceNo | string | M-必填 | ||||
| 交易传输时间 | traceTime | string | M-必填 | ||||
| 兑换日期 | exchangeDate | string | C-按条件必填 | 交易成功，交易币种和清算币种不一致的时候返回 | |||
| 汇率 | exchangeRate | string | C-按条件必填 | 交易成功，交易币种和清算币种不一致的时候返回 | |||
| 签名公钥证书 | signPubKeyCert | string | C-按条件必填 | 此域填写银联签名公钥证书，使用RSA签名方式时，默认返回，如果ctrlRule第五位为1时，不返。 | |||
| 账号 | accNo | string | C-按条件必填 | 根据商户配置返回 |
示例代码
https://open.unionpay.com/tjweb/acproduct/APIList?acpAPIId=276&&apiservId=448&&version=V2.2
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
