Overview

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

Note :

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

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

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

文件位置和命名规则

文件层级与文件代码

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

文件层级	文件代码	报表名称模板
机构层级	A-File-02	`Acquirer_Settlement_Detail_(Version No)_(Inscode)_YYYYMMDD`
集团层级	G-File-02	`Group_Settlement_Detail_(Version No)_(Groupcode)_YYYYMMDD`
商户层级	M-File-02	`Merchant_Settlement_Detail_(Version No)_(Merchantcode)_YYYYMMDD`
门店层级	S-File-02	`Store_Settlement_Detail_(Version No)_(Storecode)_YYYYMMDD`

文件名称字段说明

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

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

文件名示例

生产环境（机构层级）

Acquirer_Settlement_Detail_P003_88888888_20230108.csv

测试环境（机构层级）

Acquirer_Settlement_Detail_T003_88888888_20230108.csv

带批次号（机构层级）

Acquirer_Settlement_Detail_P003_88888888_20230108_001.csv

SFTP路径与登录

项	说明
SFTP模式	Evo Payment为SFTP Server
默认目录	`/in/{YYYYMMDD}`
登录方式	公私钥
传输完成标识	同名`.ok`后缀TXT空文件（如`Acquirer_Settlement_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-02 Settlement_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	Crossborder Flag	跨区标识
53	Merchant Sttl Amt	商户清算金额
54	Merchant Discount Amt	商户优惠金额
55	Merchant Sttl Curr	商户清算币种
56	Rate from Merchant Txn to Sttl	商户清算汇率
57	MDR Rules	商户手续费计费规则
58	MDR Amount	商户清算手续费
59	PSP Interchange Fee	发卡行交换费（IC）
60	PSP Scheme Fee	卡组织手续费（+）
61	Acquirer Service Fee	收单服务费（+）
62	Txn Service Fee	商户交易手续费
63	VAT Amount	增值税费金额
64	WHT Amount	预提税费金额
65	Net Merchant Sttl Amt	商户清算净金额
66	Metadata	备注信息
67	PSP Batch	清算批次号

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	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	ECI	Txn Status	System Result Code	PSP Result Code	PSP Authorization Code	Crossborder Flag	Merchant Sttl Amt	Merchant Sttl Curr	MDR Rules	MDR Amount	Net Merchant Sttl Amt
26523394_90244173_Hrqoqceyrkthg	PSP8	A735966	Group6	M286567	Merchant23	S160474	Store25	5399	JPN	RedactedCity-74099BA09AFA	2028-07-05T00:49:04+09:00	2028-07-05T00:49:04+09:00	2028-07-05T00:49:07+09:00	Payment	Visa	Recurring	NeVGTYMOVGhMB6jMa0URDm0HOD4DF	642149322650253445331730014130	0205064736274728188011				355644******5494	Debit	N	Consumer	KOR	2346	2346	JPY	05	Success	S0000	AUTHORIZED	360805	International	2346	JPY	Fixed Percentage	-70	2276
26523394_90244173_Hrqoqceyrkthg	PSP8	A735966	Group6	M286567	Merchant23	S160474	Store25	5399	JPN	RedactedCity-74099BA09AFA	2028-07-05T17:14:51+09:00	2028-07-05T17:14:51+09:00		Refund	Visa	Recurring	WtEFQQZWJLMPrX8psFFnojxrKOSN	996631999132553482135934128483	4524861081769715421785	ZuMNEsAx5OHZdN2AxUl6Rii0m1SR	023252084567341672876579584939	6256288209245114546719	912058******9906	Credit	F	Consumer	VNM	-1022		JPY		Success	S0000	VOIDED	656162	International	-1022	JPY	Fixed Percentage	30	-992
21095229_46778033_Xqivuopk	PSP8	A735966	Group6	M286567	Merchant23	S160474	Store25	5399	JPN	RedactedCity-74099BA09AFA	2028-07-05T00:00:36+09:00	2028-07-05T00:00:36+09:00		Refund	Mastercard	Recurring	JdVJXZXY9sP59GD1oQZD2zaKkONR	719563044268562131349184629598	8347494672782183649032	LvZIXnL9hsPquyzPyqBI35vV6EHJ	481913982199818826585319517358	6325298796438306434981	602233******9742	Credit	MCS	Consumer	JPN	-2798		JPY		Success	S0000	VOIDED	194946	Domestic	-2798	JPY	Fixed Percentage	66	-2732
21095229_46778033_Xqivuopk	PSP8	A735966	Group6	M286567	Merchant23	S160474	Store25	5399	JPN	RedactedCity-74099BA09AFA	2028-07-05T12:19:16+09:00	2028-07-05T12:19:16+09:00	2028-07-05T12:19:20+09:00	Payment	Mastercard	Recurring	TxPILu3Sz4ewam3rl8AtquBAP2JdC	596651524322398282649745253022	9496521140990556433472				897426******5587	Credit	MCT	Consumer	JPN	17073	17073	JPY	01	Success	S0000	AUTHORIZED	819780	Domestic	17073	JPY	Fixed Percentage	-405	16668

File-02 Settlement_Detail 清算交易流水明细文件

Overview#

文件位置和命名规则#

文件层级与文件代码#

文件名称字段说明#

文件名示例#

SFTP路径与登录#

Report structure#

文件基本属性#

文件生成时间#

File data elements#

Samples#