Overview

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

Note :

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

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

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

文件位置和命名规则

文件层级与文件代码

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

文件层级	文件代码	报表名称模板
机构层级	A-File-01	`Acquirer_Activity_Detail_(Version No)_(Inscode)_YYYYMMDD`
集团层级	G-File-01	`Group_Activity_Detail_(Version No)_(Groupcode)_YYYYMMDD`
商户层级	M-File-01	`Merchant_Activity_Detail_(Version No)_(Merchantcode)_YYYYMMDD`
门店层级	S-File-01	`Store_Activity_Detail_(Version No)_(Storecode)_YYYYMMDD`

文件名称字段说明

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

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

文件名示例

生产环境（机构层级）

Acquirer_Activity_Detail_P003_88888888_20230108.csv

测试环境（机构层级）

Acquirer_Activity_Detail_T003_88888888_20230108.csv

带批次号（机构层级）

Acquirer_Activity_Detail_P003_88888888_20230108_001.csv

SFTP 路径与登录

项	说明
SFTP 模式	Evo Payment 为 SFTP Server
默认目录	`/in/{YYYYMMDD}`
登录方式	公私钥
传输完成标识	同名 `.ok` 后缀 TXT 空文件（如 `Acquirer_Activity_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-01 Activity_Detail 文件的字段要素。

序号	字段名称	中文释义
1	PSP ID	支付 PSP ID 仅在机构层级文件中出现
2	PSP Name	支付 PSP 名称仅在机构层级文件中出现
3	Group ID	集团号仅在机构和集团层级文件中出现
4	Group Name	集团名称仅在机构和集团层级文件中出现
5	Merchant ID	商户号仅在机构、集团和商户层级文件中出现
6	Merchant Name	商户名称仅在机构、集团和商户层级文件中出现
7	Store ID	门店号
8	Store Name	门店名称
9	Store MCC	门店 MCC
10	Terminal ID	终端号
11	Merchant Nation	商户国家
12	Merchant City	商户城市
13	Merchant Txn Time	商户交易时间
14	System Txn Time	Evo Payment 系统交易时间
15	Txn Pay Time	PSP 交易时间
16	API Type	API 类别
17	Txn Type	交易类型
18	Payment Brand	支付品牌
19	Payment Method Variant	付款方式
20	Merchant Txn ID	商户交易号
21	Merchant Order Reference	商户订单参考信息
22	System Txn ID	Evo Payment 交易号
23	PSP Txn ID	PSP 交易号
24	Original Merchant Txn ID	原交易商户交易号
25	Original System Txn ID	原 Evo Payment 交易号
26	Original PSP Txn ID	原交易 PSP 交易号
27	Card Number	卡号（前 6 位 + `******` + 后 4 位）
28	Funding Type	卡借贷记标识
29	Product ID	卡产品标识
30	Product Type ID	卡类别标识
31	Issuer Country	发卡国家
32	Merchant Local Amt	商户本地金额
33	Local Tips Amt	小费本地金额
34	Local Surcharge Fee Amt	额外服务费本地金额
35	Local Capture Amt	商户确认本地金额
36	Merchant Local Curr	商户本地币种
37	Rate of Local to Txn	MCP/DCC 汇率
38	Merchant Txn Amt	商户交易金额
39	Tips Amount	小费交易金额
40	Surcharge Fee Amt	额外服务费用金额
41	Merchant Capture Amt	商户确认金额
42	Merchant Txn Curr	商户交易币种
43	User Billing Amt	用户扣账金额
44	User Billing Curr	用户扣账币种
45	ECI	认证标识
46	Txn Initiation Mode	交易发起方式
47	LinkPay Order ID	LinkPay 订单号
48	Txn Status	Evo Payment 系统交易状态
49	System Result Code	Evo Payment 返回应答码
50	PSP Result Code	PSP 渠道应答码
51	PSP Authorization Code	PSP 渠道授权码
52	Metadata	备注信息

Samples

PSP ID	PSP Name	Group ID	Group Name	Merchant ID	Merchant Name	Store ID	Store Name	Store MCC	Merchant Nation	Merchant City	Merchant Txn Time	System Txn Time	Txn Pay Time	Txn Type	Payment Brand	Payment Method Variant	Merchant Txn ID	Merchant Order Reference	System Txn ID	PSP Txn ID	Original Merchant Txn ID	Original System Txn ID	Original PSP Txn ID	Card Number	Funding Type	Product ID	Product Type ID	Issuer Country	Merchant Txn Amt	Merchant Capture Amt	Merchant Txn Curr	User Billing Amt	User Billing Curr	ECI	Txn Initiation Mode	LinkPay Order ID	Txn Status	System Result Code	PSP Result Code	PSP Authorization Code
678536	PSP3	A482660	Group3	M517887	Merchant6	S722145	Store6	5912	HKG	RedactedCity-9C6867C77D8F	2028-07-28T00:01:35+08:00	2028-07-28T00:01:35+08:00	2028-07-28T08:02:16+08:00	Payment	Mastercard		wsx_9udww3f1ruexn1a27q685g9o2958	SVB4692NN83-490046QP-MX5H	knn-7595509283537879588299792255	ARO237XR22012				498596******2679	Credit	F	Consumer	BGR	4560	4560	JPY	4560	JPY	02	WEB	WIY6074EA81-151336WK-XY0P	Success	S0000	00	569278
678536	PSP3	A482660	Group3	M563769	Merchant7	S977122	Store7	5816	HKG	RedactedCity-062235E8EC8D	2028-07-28T00:01:35+08:00	2028-07-28T00:01:35+08:00		Payment Method	Mastercard	COF	FUGP1340286363721368066194230		drp-1839735299023828451407950994	HHT54O3M24236				023807******4491					0.00		AED	0.00	USD		WAP		Success	S0000	85	328035
evonet	PSP4	A482660	Group3	M58547679728548	Merchant10	S591544	Store10	5816	HKG	RedactedCity-062235E8EC8D	2028-07-28T00:03:26+08:00	2028-07-28T00:03:26+08:00		Payment	Visa	COF	2s2i7j71o72228zd54m913x5251n38qj	541080503883999087	gne-4564058437006224189790850916					513196******6029	Credit	MCS	Consumer	FRA	1490.00		TWD			07	WAP	942370319295211670	Failed	B0028	4001
678536	PSP3	A482660	Group3	M249015	Merchant8	S911250	Store8	5962	HKG	RedactedCity-DEEFD6D64099	2028-07-28T00:26:54+08:00	2028-07-28T00:26:55+08:00		ASI	Mastercard		2k0099oo4ur1m4hzbwx54i77		jkk-5024625105199924679989773187	LAU162HJ03680				627391******1947					0.00		HKD	0.00	USD		WEB		Failed	P0025	79
51147459793433628540038245526Oc77v2Imbt740299637	PSP2	A638521	Group1	M964241	Merchant3	S914168	Store3	7409	HKG	RedactedCity-9C6867C77D8F	2028-07-28T00:47:22+08:00	2028-07-28T00:47:22+08:00		Refund	DANA	DANA	1796980367108195301102304		vhz-3142743769189857373828996207	4158349574999669623608855424851	5471254193437473714019642	gef-0528493146391969972271808463	9159963337255972887221449077054						-599000.00		IDR				APP		Success	S0000	SUCCESS
evonet634e	PSP1	A482660	Group3	M826246	Merchant17	S130148	Store18	5945	HKG	RedactedCity-062235E8EC8D	2028-07-28T01:33:33+08:00	2028-07-28T01:33:33+08:00		Cancel	Toss_Pay		13801828736808482067633		781432992671892775499786432982		ncw_809i5at2cwyqi19sh2284253lg94	855531642899548051649202489954							-10000		KRW				WAP		Processing	S0007

File-01 Activity_Detail 联机交易流水明细文件

Overview#

文件位置和命名规则#

文件层级与文件代码#

文件名称字段说明#

文件名示例#

SFTP 路径与登录#

Report structure#

文件基本属性#

文件生成时间#

File data elements#

Samples#