中国银联开放平台

支持中心

接口列表

订购

消费接口

消费撤销接口

退货接口

交易状态查询接口

预授权接口

预授权撤销

预授权完成

预授权完成撤销

银联加密公钥更新查询接口

文件传输接口

订购

查看产品

更新时间：2023-07-14

文件传输接口

接口描述

商户需开发“文件传输类交易”接口获取对账文件。

请求方式

POST

生产调用地址

https://filedownload.95516.com/

测试调用地址

https://filedownload.test.95516.com/

请求参数

中文名称	英文名称	域类型	默认值	请求要求	备注
编码方式	encoding	ANS1..20	UTF-8	M-必填	默认取值：UTF-8
签名	signature	ANS1..1024	0	M-必填	填写对报文摘要的签名
产品类型	bizType	N6	无	M-必填	000000
接入类型	accessType	N1	无	M-必填	0：商户直连接入 1：收单机构接入 2：平台商户接入
收单机构代码	acqInsCode	AN8..11	无	C-按条件必填	接入类型为收单机构接入时需上送
商户代码	merId	AN15	无	M-必填
订单发送时间	txnTime	YYYYMMDDhhmmss	无	M-必填
文件类型	fileType	N2	无	M-必填	据实际业务情况定义参考7.1：商户索取的文件类型约定
清算日期	settleDate	MMDD	无	M-必填
签名方法	signMethod	N2	无	M-必填	非对称签名： 01（表示采用RSA签名） HASH表示散列算法 11：支持散列方式验证SHA-256 12：支持散列方式验证SM3
交易类型	txnType	N2	无	M-必填	取值:76
交易子类	txnSubType	N2	无	M-必填	01：对账文件下载
请求方保留域	reqReserved	ANS1..1024	无	O-选填	商户自定义保留域，交易应答时会原样返回
证书ID	certId	N1..128	无	C-按条件必填
版本号	version	NS5	无	M-必填	固定填写5.1.0

应答报文（同步应答）

中文名称	英文名称	域类型	默认值	请求要求	备注
编码方式	encoding	ANS1..20	UTF-8	R-需要返回
签名	signature	ANS1..1024	0	M-必填
产品类型	bizType	N6	无	R-需要返回
接入类型	accessType	N1	无	R-需要返回	0：商户直连接入 1：收单机构接入 2：平台商户接入
收单机构代码	acqInsCode	AN8..11	无	C-按条件必填
商户代码	merId	AN15	无	R-需要返回
订单发送时间	txnTime	YYYYMMDDhhmmss	无	R-需要返回
文件类型	fileType	N2	无	R-需要返回
文件名	fileName	ANS1..64	无	M-必填
批量文件内容	fileContent	ANS1..1000000	无	M-必填	文件流方式
清算日期	settleDate	MMDD	无	R-需要返回
应答码	respCode	AN2	无	M-必填
应答信息	respMsg	ANS1..256	无	M-必填
签名方法	signMethod	N2	无	M-必填
交易类型	txnType	N2	无	R-需要返回	取值:76
交易子类	txnSubType	N2	无	R-需要返回	01：对账文件下载
请求方保留域	reqReserved	ANS1..1024	无	R-需要返回
证书ID	certId	N1..128	无	C-按条件必填
版本号	version	NS5	无	R-需要返回	固定填写5.1.0

异常应答说明

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

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

提示信息

提示