中国银联开放平台

支持中心

接口列表

银联签约支付

银联签约支付

交易状态查询

签约方信息查询

营销活动列表查询

营销活动余额查询

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

银联签约支付

更新时间：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.discount.list.query
	发送方流水号	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-按条件必填	已被批准加入银联互联网系统的收单机构代码接入类型为收单机构接入时需上送
	商户信息域	merInfo	Object		C-按条件必填	查看详情
	二级商户信息域	subMerInfo	Object		C-按条件必填	查看详情
	商户代码	merId	String[15]		M-必填	已被批准加入银联互联网系统的商户代码固定15位长，仅支持数字和字母
	商户订单号	orderId	String(8..40)		M-必填	商户订单号，不能含“-”或“_”仅支持数字和字母
	交易发送时间	txnTime	String[14]		M-必填	商户发送交易时间，格式： yyyyMMddHHmmss
	请求方保留域	reqReserved	String(1..1024)		C-按条件必填	商户自定义保留域，交易应答时会原样返回
	交易金额	txnAmt	String(1..12)		M-必填	仅支持数字。单位为币种对应的最小单位，参数值不能带小数仅支持数字
	交易币种	currencyCode	String[3]		M-必填	3位数字。币种格式必须为3位代码，默认取值：156（人民币）
	交易场景	transScene	String[3]		M-必填	营销活动承兑时的真实交易类型 002：收银台签约支付
	账户验证信息域	accountVerifyInfo	Object		C-按条件必填	查看详情
	Token信息域	tokenInfo	Object		C-按条件必填	查看详情
	营销信息域	discountInfo	Object		C-按条件必填	查看详情
	掩码卡号	maskedCardNo	String(16..19)		C-按条件必填	营销活动承兑时的真实掩码卡号前6后4明文，其余*替换。
	加密信息域	encryptData	Object		C-按条件必填	查看详情
	商户控制信息域	merCtrlInfo	Object		O-选填	查看详情

同步应答业务参数

	中文名称	英文名称	域类型	默认值	请求要求	备注
	应答码	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)		C-按条件必填	商户自定义保留域，交易应答时会原样返回
	营销信息域	discountInfo	Object		C-按条件必填	查看详情

咨询服务