全部
全部
更新时间:2020-11-12 21:04:08
1.范围

本标准规定了商户与中国银联全渠道系统之间的文件交换关系,包括文件的存取方式、文件名及记录格式的约定。

本标准适用于所有接入中国银联全渠道系统的商户。

接入全渠道的机构,其对账文件适用于《中国银联银行卡联网联合技术规范》第3部分 文件接口的ACOMN文件。

2.规范性引用文件

下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。

Q/CUP 006 《银行卡联网联合技术规范V2.1》

Q/CUP 001 《银行卡信息交换术语》

3.流水文件基本约定

3.1 流水文件命名规则

明细流水文件名定义说明如下表:

1.png

3.2 流水文件结构

流水文件的结构如下:

2.png

注:

1、在同一个文件中,每一行的长度相同;

2、每一行是一条记录,表示一笔交易;

3、每一行的最后一个域之后跟一个回车换行符(0x0D,0x0A)。

3.3 流水文件记录结构

流水文件中的每条记录构成如下:

3.png

注:

1、每个字段之间以空格分隔;(若字段N为保留使用字段,则在流水文件记录格式中,所规定的该保留字段的长度不包括其前的一位空格。如:一条记录全长为30,已定义了两个字段:字段A(长度为10)、字段B(长度为10),则保留使用的字段长度应为8)

2、每条记录以(0x0D,0x0A)结束。

3.4 流水符号定义

文件记录格式中出现的符号定义如下:

4.png

4.批量文件基本约定

全渠道支持三种类型的批量文件:代收、代付和退货,每种类型的文件包含三种不同类别的件:请求文件(业务上称为“报盘文件”)、拒绝文件和结果文件(业务上称为“回盘文件”)。其中,请求文件由商户或机构生成,并通过联机、网站或FTP方式上传给银联全渠道系统;拒绝文件和结果文件由银联全渠道系统生成。其中拒绝文件是仅针对文件重复上传、文件体中金额域格式非法等错误返回的特殊结果文件,其内容由应答码和应答码描述组成的一行文件体;而结果文件则包含请求文件的原始内容及其对应明细的应答码等回盘信息。

除拒绝文件只有一行内容(位于第一行)外,请求文件和结果文件均由两部分组成:文件头(位于第一行)和文件体。其中,文件体由标题行(位于第二行)和内容行(位于第三行至最后一行)组成,内容行至少有一行记录。

批量文件的类型和类别分别由文件名称的前2位字符和第38位字符标识。文件格式支持纯文本文件(后缀为.txt)和微软EXCEL文件(后缀为.xlsx和.xls),由文件名称中的第39位至第42或43位字符标识,具体描述请参考“文件命名规则”章节。对于纯文本文件,文件头和文件体中每一行中的域名或域值均以半角竖线(|)分割,并以回车(0x0D)换行(0x0A)符作为结尾标识,文件的编码支持GBK和UTF-8。联机方式不支持EXCEL格式的文件,且所有明细记录需放在第一个工作表格中,域名或域值填写在单元格中。

4.1 符号说明

M:必填

C:满足某条件时必填

O:可选

R:原样返回,如果请求文件中包含该域则返回,否则不返回

4.2 批量文件命名规则

QQ图片20180629105449.png

4.3 文件头结构定义


所有类型(代收、代付和退货)的批量文件的文件头,均遵循相同的结构定义,本节统一对文件头的结构定义进行描述。具体示例请参考“批量文件示例”章节。

4.3.1 请求文件头

blob.png

4.3.2 拒绝文件头

所有类型的拒绝文件均没有文件头。

4.3.3 结果文件头

blob.png

4.4 文件体结构定义

对于请求文件,文件体中标题行的域名取值,可使用中文(“域名”列)或英文(“变量名”列),但不可中英文混用。对于出现要求为“O”和不满足条件的“C”的域,接入方在保证交易要素完整的基础上,标题行及内容行中可以不用填写这些域,其对应的结果文件也不返回。

对于拒绝文件,没有标题行,其文件体由以半角竖线分割的应答码和应答码描述组成的一行记录。

对于结果文件,其内容为在原始请求文件的基础上,增加交易的应答及清算等信息,这些信息总是排列在原始请求文件各域的左侧。目前增加的信息有七个域,其中应答码、应答码描述、交易查询流水号、系统跟踪号、系统时间这五个域总是返回,银联保留域1和银联保留域2为可选返回域。

4.4.1 代收文件

4.4.1.1请求文件体

blob.png

blob.png

4.4.1.2拒绝文件体

blob.png

注:拒绝文件的文件体没有标题行。

4.4.1.3结果文件体

blob.png

blob.png

4.4.2 代付文件

4.4.2.1请求文件体

blob.png

blob.png

4.4.2.2拒绝文件体

同“4.4.1.2”节。

4.4.2.3结果文件体

blob.png

blob.png

4.4.3 退货文件

4.4.3.1请求文件体

blob.png

4.4.3.2拒绝文件体

同“4.4.1.2”节。

4.4.3.3结果文件体

blob.png

blob.png

4.4.4 元数据定义列表

附注1:账号类型取值列表

blob.png

附注2:产品类型取值列表

blob.png

附注3:证件类型取值列表

blob.png

附注4:账单类型取值列表

blob.png

blob.png

注:后续章节中批量文件示例及文件列表格式说明需访问

https://open.unionpay.com/ajweb/help/file/toDetailPage?id=585&flag=1网站的“帮助中心”--“下载”栏目查看。

5.文件清单

对一般全渠道商户可拿到以下报表:

blob.png

全渠道集团商户涉及以下文件报表:

1、全渠道商户一般交易流水文件:包含所有合并商户一般交易在内的流水;

2、全渠道商户差错交易流水文件:包含所有合并商户差错交易在内的流水;

3、全渠道商户周期交易流水文件:包含所有合并商户周期一般交易在内的流水;

4、全渠道商户周期差错交易流水文件:包含所有合并商户周期差错交易在内的流水;

5、全渠道商户汇总报表(若集团商户自身作为商户,也会发生交易, 则会生成该报表);

6、全渠道集团商户汇总报表。

说明:对全渠道集团商户,使用的流水文件名1、2、3、4同一般全渠道商户。即全渠道商户文件中包含合并商户的所有交易信息。 

若集团商户自身作为商户,也会发生交易,不会拿到仅包含自身交易的文件流水。

集团商户汇总报表清单:

blob.png

6.文件列表及格式说明

6.1 (ZM)商户一般交易明细流水文件记录格式


商户一般交易明细流水文件记录格式  (INNYYMMDD??ZM_***************)

blob.png

blob.png

blob.png

注1:交易代码取值如下:

blob.png

blob.png

blob.png

blob.png

blob.png

blob.png

blob.png

blob.png

blob.png

blob.png

blob.png

blob.png

注2:按照风险管理要求,主账号仅保留前6位和后4位,中间用*号屏蔽,对于主账号为非卡号的截取后19位,屏蔽规则不变。

注3:“旧支付方式”的含义为“01-认证支付,02-快捷支付,03-普通支付,04-储值卡支付,05-网银支付,06-后台支付,07-小额支付,08-账户绑定验证,09-银联认证支付开通验证,10-小额支付开通验证,11-牡丹畅通卡支付,12-IC卡支付,13-中铁银通卡支付”,启用交易新接口后,“旧支付方式”将弃用,固定填为“00”。

注4:默认为空,如为后续类交易,则显示相应原交易信息,以一笔消费交易的后续退货交易为例,该退货交易的“原始交易的系统跟踪号”、“原始交易日期时间”即指原消费交易的系统跟踪号和交易日期时间。

注5:商户手续费,对于银联代理清算(直联清算)商户,体现商户应付手续费金额;对于间联清算商户,体现的商户手续费为空。类型长度中的“X”取值为“C”,表示贷记;“X”取值为“D”,表示借记。


 

6.2 (ZME)商户差错交易明细流水文件记录格式


商户差错交易明细流水文件记录格式 (INNYYMMDD??ZME_***************)

blob.png

blob.png

注1: 差错交易代码取值:E04:差错-调单、E05:调单回复、E22:请款、E23:退单、E24:再请款、E25:二次退单、E31:发卡方发起的差错例外、E32:贷记调整、E73-受理方发起的差错例外、E74:能查找到原始交易的手工退货、E84:不能查找到原始交易的手工退货。

注2:上一笔交易的系统跟踪号、上一笔交易的日期时间、上一笔交易清算日期、上一笔交易金额:这四个字段中的“上一笔交易”指引发本次交易的紧邻的上一笔交易。

注3:商户手续费:对于银联代理清算(直联清算)商户,体现回退给商户的原始交易手续费金额。对于间联清算商户,体现的商户手续费为0。

6.3 (RD2010) 全渠道商户日对账交易汇总报表表样

报表名:RN2010YYMMDD01_XXXXXXXXXXXXXXX 

blob.png


消费

   



消费撤销

   



自助消费

自助消费撤销

MOTO消费

MOTO消费撤销

分期付款消费

分期付款消费撤销

预授权完成

预授权完成撤销

自助预授权完成

自助预授权完成撤销

MOTO预授权完成

MOTO预授权完成撤销

实时代收

实时代收撤销

批量代收

实时代付

批量代付

联机退货

分期付款退货

请款

再请款

退单

二次退单

贷调

手工退货

手工单退货

。。。

。。。

其他


总计

blob.png

6.4 (RDG2010) 全渠道集团商户日对账交易汇总报表表样


集团商户:下辖独立子商户,与其子商户分别在银联进行入网,并拥有各自的收单系统。集团商户通过相应业务流程,可获取合并的其下辖各子商户的合并对账文件。集团商户与其下辖的子商户进行独立资金划拨与清算。例如:A商户下辖100家营业厅,每个营业厅以商户身份入网,并自行签署收单机构。A商户作为集团商户,每日获取的全渠道流水和报表文件,包含“A商户”自身以及下辖100家营业厅的交易。但是“A商户”和100家营业厅的资金,则分别由各自收单机构进行划付。

报表名:RNG2010YYMMDD01_XXXXXXXXXXXXXXX

集团商户报表表样如下:

blob.png

blob.png

blob.png

注:格式说明

——该报表分多个统计块:
第一部分为集团商户的汇总信息,包括所有商户在内的汇总:
第二部分为各个商户的汇总信息。
如有A,B,C共3个商户,C作为集团商户,若当日ABC均发生了交易汇总各为100,200,300,则C作为集团商户生成的RDG2010报表包含如下:

1)集团商户C:600;

2)子商户A:100;

3)子商户B:200;

4)子商户C:300。

——各统计项说明同RD2010。


咨询服务