Overview

Evo Payment 清分清算系统按照客户指定的日切时间点，产出前一自然日日切周期内的全部网络令牌密文明细文件，供客户进行自动化交易勾对与对账处理。

Note :

文件包含全部交易状态的联机交易（含失败状态交易）；

若前一日客户未产生联机交易，则产出空文件，仅保留字段名称及结束标识 END；

开启大文件拆分功能后，文件名称中会增加 BatchNum（001–999）后缀。

文件位置和命名规则

文件层级与文件代码

Evo Payment 可根据客户在系统中配置的不同层级产出不同维度明细。文件代码及报表名称按层级区分如下：

文件层级	文件代码	报表名称模板
机构层级	A-File-08	`Acquirer_Network_Token_Cryptogram_Detail_(Version No)_(Inscode)_YYYYMMDD`
集团层级	G-File-08	`Group_Network_Token_Cryptogram_Detail_(Version No)_(Groupcode)_YYYYMMDD`
商户层级	M-File-08	`Merchant_Network_Token_Cryptogram_Detail_(Version No)_(Merchantcode)_YYYYMMDD`
门店层级	S-File-08	`Store_Network_Token_Cryptogram_Detail_(Version No)_(Storecode)_YYYYMMDD`

文件名称字段说明

每个字段使用下划线（_）连接，字段含义如下：

字段	说明
固定值	`Acquirer_Network_Token_Cryptogram_Detail` / `Group_Network_Token_Cryptogram_Detail` / `Merchant_Network_Token_Cryptogram_Detail` / `Store_Network_Token_Cryptogram_Detail`，对应该层级
版本号	第一位为文件标识：`P` 生产环境、`T` 测试环境；后三位为数字编号，从 `001` 起至最大 `999`（新版本兼容旧版本）
Inscode/Groupcode/Merchantcode/Storecode	客户的机构、集团、商户或门店标识符
日期	`YYYYMMDD`，报表生成日期
批次号（可选）	当机构文件配置 `Batch Generate Threshold` 功能时增加，取值范围 `001`–`999`

文件名示例

生产环境（机构层级）

Acquirer_Network_Token_Cryptogram_Detail_P003_88888888_20230108.csv

测试环境（机构层级）

Acquirer_Network_Token_Cryptogram_Detail_T003_88888888_20230108.csv

带批次号（机构层级）

Acquirer_Network_Token_Cryptogram_Detail_P003_88888888_20230108_001.csv

SFTP 路径与登录

项	说明
SFTP 模式	Evo Payment 为 SFTP Server
默认目录	`/in/{YYYYMMDD}`
登录方式	公私钥
传输完成标识	同名 `.ok` 后缀 TXT 空文件（如 `Acquirer_Network_Token_Cryptogram_Detail_P003_88888888_20230108.csv.ok`）

Important : 客户端在拉取并解析对账文件前，应先检查同名 .ok 文件是否存在，以确认 Evo Payment 已完成文件传输。

Report structure

文件基本属性

属性	值
文件格式	CSV
文件编码	UTF-8 带 BOM
换行符	`\n`（`0x0A`）
字段分隔符	双引号 + 英文逗号 `","`
文件内容结束标识	`*END*`（最后一行）

文件生成时间

生成周期：自然日文件，每周一至周日产出

生成时间：每日 10:00–12:00 AM（Evo Payment 节点系统时间）

File data elements

本节定义 File-08 Network_Token_Cryptogram_Detail 文件的字段要素。

序号	字段名称	中文释义
1	Group ID	集团号仅在机构层级文件中出现
2	Group Name	集团名称仅在机构层级文件中出现
3	Merchant ID	商户号仅在机构和集团层级文件中出现
4	Merchant Name	商户名称仅在机构和集团层级文件中出现
5	Store ID	门店号仅在机构、集团和商户层级文件中出现
6	Store Name	门店名称仅在机构、集团和商户层级文件中出现
7	Merchant Txn Time	商户交易时间
8	API Type	API 类别
9	Txn Type	交易类型
10	Payment Brand	支付品牌
11	Merchant Txn ID	商户交易号
12	Merchant Order Reference	商户订单参考信息
13	Card Number	卡号（前6******后4）
14	Merchant Txn Curr	商户本地币种
15	Merchant Txn Amt	商户交易金额
16	Authentication Type	认证类型
17	ECI	认证标识
18	Txn Status	交易状态
19	Token ID	令牌号
20	Token Reference ID	令牌唯一参考号
21	Token	令牌（前6******后4）
22	Payment Account Reference	支付账户参考
23	Metadata	备注信息

Samples

Group ID	Group Name	Merchant ID	Merchant Name	Store ID	Store Name	Merchant Txn Time	API Type	Txn Type	Payment Brand	Merchant Txn ID	Merchant Order Reference	Card Number	Merchant Txn Curr	Merchant Txn Amt	Authentication Type	ECI	Txn Status	Token ID	Token Reference ID	Token	Payment Account Reference	Metadata
A679882	Group9	M228718	Merchant31	S819947	Store49	2028-07-07T10:48:03+08:00		Cryptogram	VIS	gxt_hxerfqoj5z94794_RA_56q1444i		903207******2875					Success	6013yoa37533e41g8424939hi859b119	DNITHE260349868657627826	104717******7873	V1188181795690816544729077347

File-08 Network_Token_Cryptogram_Detail 网络令牌密文明细文件

Overview#

文件位置和命名规则#

文件层级与文件代码#

文件名称字段说明#

文件名示例#

SFTP 路径与登录#

Report structure#

文件基本属性#

文件生成时间#

File data elements#

Samples#