中国银联开放平台

支持中心

接口列表

银联签约支付

银联签约支付

交易状态查询

签约方信息查询

营销活动列表查询

营销活动余额查询

对账文件接口-文件传输类交易接口

银联签约支付

更新时间：2023-08-17

消费撤销

接口描述

消费撤销

请求方式

POST

生产调用地址

https://gateway.95516.com/api/v7/trans.do

测试调用地址

https://gateway.test.95516.com/api/v7/trans.do

公共参数

	中文名称	英文名称	域类型	默认值	请求要求	备注
	版本号	version	String(1..8)		M-必填	7.0.1
	发送方系统索引号	appId	String(1..32)		M-必填	当普通商户直连接入、平台类商户接入时，填商户号。当收单机构接入时，填收单机构号。
	发送方索引类型	appType	String[2]		M-必填	本数据元的填写须根据报文发送方的实际角色进行填写。当普通商户直连接入、平台类商户接入时，填02。当收单机构接入时，填01。
	接口类型	bizMethod	String(1..64)		M-必填	bizMethod 取值为：acp.trade.cancel
	发送方流水号	reqId	String(1..64)		M-必填	由发送方自行生成，保证每笔请求不重复。同步应答原样返回，异步应答生成新值。
	签名	sign	String(1..344)		M-必填	对报文摘要的签名
	证书ID	signId	String(1..128)		M-必填	签名证书序列号（十进制）
	签名或摘要方式	signMethod	String(1..20)		M-必填	取值详见技术规范

请求业务参数

	中文名称	英文名称	域类型	默认值	请求要求	备注
	接入类型	accessType	String[1]		M-必填	0：普通商户直连接入1：收单机构接入2：平台类商户接入
	收单机构代码	acqInsCode	String(8..11)		C-按条件必填	已被批准加入银联互联网系统的收单机构代码接入类型为收单机构接入时需上送
	二级商户信息域	subMerInfo	Object		C-按条件必填	查看详情
	商户代码	merId	String[15]		M-必填	已被批准加入银联互联网系统的商户代码固定15位长，仅支持数字和字母
	商户订单号	orderId	String(8..40)		M-必填	商户订单号，不能含“-”或“_”仅支持数字和字母
	交易发送时间	txnTime	String[14]		M-必填	商户发送交易时间，格式： yyyyMMddHHmmss
	请求方保留域	reqReserved	String(1..1024)		O-选填	商户自定义保留域，交易应答时会原样返回
	交易金额	txnAmt	String(1..12)		M-必填	仅支持数字。单位为币种对应的最小单位，参数值不能带小数仅支持数字
	原交易受理订单号	origTn	String[21]		C-按条件必填	origTn 与 origOrderId+origTxnTime 上送其一后续类交易中用于标识关联交易的tn21位定长，仅支持数字
	原交易商户订单号	origOrderId	String(8..40)		C-按条件必填	原交易订单号，格式同orderId
	原交易发送时间	origTxnTime	String[14]		C-按条件必填
	后台通知地址	backUrl	String(1..256)		C-按条件必填	后台返回商户结果时使用，如上送，则发送商户后台交易结果通知，不支持换行符等不可见字符，如需通过专线通知，需要在通知地址前面加上前缀：专线的首字母加竖线ZX\|

同步应答业务参数

	中文名称	英文名称	域类型	默认值	请求要求	备注
	应答码	code	String[10]		M-必填	对调用结果进行统一归类，指导开发者判断并进行后续业务操作。数据字典见附录A《应答码》。
	应答码描述	msg	String(1..128)		M-必填	同一个应答码可对应多个不同的描述，对处理结果进行详细提示。
	详细应答码	subCode	String[10]		M-必填	描述了详细的业务处理失败的原因，详见每个交易接口说明，仅用于问题排查和分析，无须开发者判断。
	详细应答码描述	subMsg	String(1..128)		M-必填	同一个详细错误码可对应多个不同的描述，对处理结果进行详细提示。
	接入类型	accessType	String[1]		R-需要返回	0：普通商户直连接入1：收单机构接入2：平台类商户接入
	收单机构代码	acqInsCode	String(8..11)		R-需要返回	已被批准加入银联互联网系统的收单机构代码
	商户代码	merId	String[15]		R-需要返回	已被批准加入银联互联网系统的商户代码固定15位长，仅支持数字和字母
	商户订单号	orderId	String(8..40)		R-需要返回	商户订单号，不能含“-”或“_”仅支持数字和字母
	交易发送时间	txnTime	String[14]		R-需要返回	商户发送交易时间，格式： yyyyMMddHHmmss
	请求方保留域	reqReserved	String(1..1024)		R-需要返回	商户自定义保留域，交易应答时会原样返回
	交易金额	txnAmt	String(1..12)		R-需要返回	仅支持数字。单位为币种对应的最小单位，参数值不能带小数仅支持数字
	交易币种	currencyCode	String[3]		C-按条件必填	3位数字。币种格式必须为3位代码，默认取值：156（人民币）
	银联受理订单号	tn	String[21]		C-按条件必填	由银联返回，用于在后续类交易中唯一标识一笔交易21位定长，仅支持数字
	清算信息域	settleInfo	Object		C-按条件必填	查看详情
	营销信息域	discountInfo	Object		C-按条件必填	查看详情
	原交易受理订单号	origTn	String[21]		C-按条件必填	后续类交易中用于标识关联交易的tn21位定长，仅支持数字

异步应答业务参数

	中文名称	英文名称	域类型	默认值	请求要求	备注
	应答码	code	String[10]		M-必填	对调用结果进行统一归类，指导开发者判断并进行后续业务操作。数据字典见附录A《应答码》。
	应答码描述	msg	String(1..128)		M-必填	同一个应答码可对应多个不同的描述，对处理结果进行详细提示。
	详细应答码	subCode	String[10]		M-必填	描述了详细的业务处理失败的原因，详见每个交易接口说明，仅用于问题排查和分析，无须开发者判断。
	详细应答码描述	subMsg	String(1..128)		M-必填	同一个详细错误码可对应多个不同的描述，对处理结果进行详细提示。
	接入类型	accessType	String[1]		R-需要返回	0：普通商户直连接入1：收单机构接入2：平台类商户接入
	收单机构代码	acqInsCode	String(8..11)		R-需要返回	已被批准加入银联互联网系统的收单机构代码
	商户代码	merId	String[15]		R-需要返回	已被批准加入银联互联网系统的商户代码固定15位长，仅支持数字和字母
	商户订单号	orderId	String(8..40)		R-需要返回	商户订单号，不能含“-”或“_”仅支持数字和字母
	交易发送时间	txnTime	String[14]		R-需要返回	商户发送交易时间，格式： yyyyMMddHHmmss
	请求方保留域	reqReserved	String(1..1024)		R-需要返回	商户自定义保留域，交易应答时会原样返回
	交易金额	txnAmt	String(1..12)		R-需要返回	仅支持数字。单位为币种对应的最小单位，参数值不能带小数仅支持数字
	交易币种	currencyCode	String[3]		C-按条件必填	3位数字。币种格式必须为3位代码，默认取值：156（人民币）
	银联受理订单号	tn	String[21]		C-按条件必填	由银联返回，用于在后续类交易中唯一标识一笔交易21位定长，仅支持数字
	清算信息域	settleInfo	Object		C-按条件必填	查看详情
	营销信息域	discountInfo	Object		C-按条件必填	查看详情
	原交易受理订单号	origTn	String[21]		C-按条件必填	后续类交易中用于标识关联交易的tn21位定长，仅支持数字

咨询服务