Overview

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

Note :

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

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

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

文件位置和命名规则

文件层级与文件代码

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

文件层级	文件代码	报表名称模板
机构层级	A-File-05	`Acquirer_PSP_Miscellaneous_Detail_(Version No)_(Inscode)_YYYYMMDD`

文件名称字段说明

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

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

文件名示例

生产环境（机构层级）

Acquirer_PSP_Miscellaneous_Detail_P003_88888888_20230108.csv

测试环境（机构层级）

Acquirer_PSP_Miscellaneous_Detail_T003_88888888_20230108.csv

带批次号（机构层级）

Acquirer_PSP_Miscellaneous_Detail_P003_88888888_20230108_001.csv

SFTP 路径与登录

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

序号	字段名称	中文释义
1	Record Date	记录日期仅在机构层级文件中出现
2	Record Type	记录类型仅在机构层级文件中出现
3	Dispute Amount Indicator	争议金额标识仅在机构层级文件中出现
4	Record Reference Number	记录参考号仅在机构层级文件中出现
5	Record Reason Code	记录理由码仅在机构层级文件中出现
6	Record Reference Information	记录参考信息仅在机构层级文件中出现
7	Acquirer ID	收单机构 ID 仅在机构层级文件中出现
8	Acquirer Name	收单机构名称仅在机构层级文件中出现
9	PSP ID	支付 PSP ID 仅在机构层级文件中出现
10	PSP Name	支付 PSP 名称仅在机构层级文件中出现
11	Group ID	集团号仅在机构层级文件中出现
12	Group Name	集团名称仅在机构层级文件中出现
13	Merchant ID	商户号仅在机构层级文件中出现
14	Merchant Name	商户名称仅在机构层级文件中出现
15	Store ID	门店号仅在机构层级文件中出现
16	Store Name	门店名称仅在机构层级文件中出现
17	Store MCC	门店 MCC 仅在机构层级文件中出现
18	Terminal ID	终端号仅在机构层级文件中出现
19	Merchant Nation	商户国家仅在机构层级文件中出现
20	Merchant City	商户城市仅在机构层级文件中出现
21	Merchant Txn Time	商户交易时间仅在机构层级文件中出现
22	System Txn Time	Evo Payment 系统交易时间仅在机构层级文件中出现
23	Txn Pay Time	PSP 交易时间仅在机构层级文件中出现
24	API Type	API 类别仅在机构层级文件中出现
25	Txn Type	交易类型仅在机构层级文件中出现
26	Payment Brand	支付品牌仅在机构层级文件中出现
27	Payment Method Variant	付款方式仅在机构层级文件中出现
28	Merchant Txn ID	商户交易号仅在机构层级文件中出现
29	Merchant Order Reference	商户订单参考信息仅在机构层级文件中出现
30	System Txn ID	Evo Payment 交易号仅在机构层级文件中出现
31	PSP Txn ID	PSP 交易号仅在机构层级文件中出现
32	Original Merchant Txn ID	原交易商户交易号仅在机构层级文件中出现
33	Original System Txn ID	原 Evo Payment 交易号仅在机构层级文件中出现
34	Original PSP Txn ID	原交易 PSP 交易号仅在机构层级文件中出现
35	Card Number	卡号（前6******后4）仅在机构层级文件中出现
36	Funding Type	卡借贷记标识仅在机构层级文件中出现
37	Product ID	卡产品标识仅在机构层级文件中出现
38	Product Type ID	卡类别标识仅在机构层级文件中出现
39	Issuer Country	发卡国家仅在机构层级文件中出现
40	Merchant Local Amt	商户本地金额仅在机构层级文件中出现
41	Local Tips Amt	小费本地金额仅在机构层级文件中出现
42	Local Surcharge Fee Amt	额外服务费本地金额仅在机构层级文件中出现
43	Local Capture Amt	商户确认本地金额仅在机构层级文件中出现
44	Merchant Local Curr	商户本地币种仅在机构层级文件中出现
45	Rate of Local to Txn	MCP/DCC 汇率仅在机构层级文件中出现
46	Merchant Txn Amt	商户交易金额仅在机构层级文件中出现
47	Tips Amount	小费交易金额仅在机构层级文件中出现
48	Surcharge Fee Amt	额外服务费用金额仅在机构层级文件中出现
49	Merchant Capture Amt	商户确认金额仅在机构层级文件中出现
50	Merchant Txn Curr	商户交易币种仅在机构层级文件中出现
51	User Billing Amt	用户扣账金额仅在机构层级文件中出现
52	User Billing Curr	用户扣账币种仅在机构层级文件中出现
53	ECI	认证标识仅在机构层级文件中出现
54	Txn Initiation Mode	交易发起方式仅在机构层级文件中出现
55	LinkPay Order ID	LinkPay 订单号仅在机构层级文件中出现
56	Txn Status	Evo Payment 系统交易状态仅在机构层级文件中出现
57	System Result Code	Evo Payment 返回应答码仅在机构层级文件中出现
58	PSP Result Code	PSP 渠道应答码仅在机构层级文件中出现
59	PSP Authorization Code	PSP 渠道授权码仅在机构层级文件中出现
60	Crossborder Flag	跨区标识仅在机构层级文件中出现
61	PSP ARN	双信息请款清算号仅在机构层级文件中出现
62	PSP Settlement Date	PSP 清算日期仅在机构层级文件中出现
63	PSP Txn Amt	PSP 交易金额仅在机构层级文件中出现
64	PSP Txn Curr	PSP 交易币种仅在机构层级文件中出现
65	Direct FX Rate	PSP 交易汇率仅在机构层级文件中出现
66	PSP Sttl Amt	PSP 清算金额仅在机构层级文件中出现
67	PSP Discount Amt	PSP 优惠金额仅在机构层级文件中出现
68	Acquirer Discount Amt	PSP 商户优惠金额仅在机构层级文件中出现
69	PSP Sttl Curr	PSP 清算币种仅在机构层级文件中出现
70	Rate for PSP TXN to Sttl	PSP 清算汇率仅在机构层级文件中出现
71	PSP Interchange Fee	PSP IC 手续费仅在机构层级文件中出现
72	PSP VAT Amount	PSP 增值税费仅在机构层级文件中出现
73	PSP WHT Amount	PSP 预扣税费仅在机构层级文件中出现
74	PSP Net Sttl Amt	PSP 清算净金额仅在机构层级文件中出现

Samples

Record Date	Record Type	Dispute Amount Indicator	Record Reference Number	Record Reason Code	Record Reference Information	Acquirer ID	Acquirer Name	PSP ID	PSP Name	Merchant ID	Merchant Name	Store ID	Store Name	Store MCC	Terminal ID	Merchant Nation	Merchant City	Merchant Txn Time	System Txn Time	Txn Pay Time	Txn Type	Payment Brand	Merchant Txn ID	Merchant Order Reference	System Txn ID	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	Txn Status	PSP Authorization Code	Crossborder Flag	PSP ARN	PSP Settlement Date	PSP Txn Amt	PSP Txn Curr	PSP Sttl Amt	PSP Sttl Curr	PSP Interchange Fee	PSP Net Sttl Amt
20280729	PSP-First ChargeBack	Full	2817976864	4853	RedactedRecordInfo-A8C320EE6625	58690282	Acquirer2	706728	PSP3	M748857	Merchant30	S50494984671308	Store38	5699	24231686	HKG	RedactedCity-9C6867C77D8F	2028-05-31T15:01:50+08:00	2028-05-31T15:01:50+08:00	2028-05-31T15:01:50+08:00	Payment	Mastercard	0614806957723339537405722	4171790375011699255952177	1684323400047298456052	3929SWEEGIVAG	813839******1365	Debit	MDH	Consumer	DEU	99.20	99.20	EUR	99.20	EUR	07	Cybersource	Success	XPXFRJ	International	34666671569232686537198	20280728	-99.20	EUR	-99.11	EUR	2.01	-97.10
20280729	PSP Fee-Debit	Full	79397409	7800	RedactedRecordInfo-C29D75B6C923	58690282	Acquirer2	706728	PSP3	M748857	Merchant30	S32844641653456	Store41	5815	24231686	HKG	RedactedCity-9C6867C77D8F	2028-06-03T22:34:29+08:00	2028-06-03T22:34:29+08:00	2028-06-03T22:34:29+08:00	Payment	Mastercard	9888338855249954203861320	0672306672696776880658284	4156846414325680319618	5577XTSSWVDUN	376575******3512	Credit	MPL	Consumer	BRA	14.99	14.99	USD	14.99	USD	07	Cybersource	Success	KR6CRS	International	39787765322613466293261	20280728			-14.99	USD		-14.99
20280729	PSP-Second Presentment	Full	3748289443	2700	RedactedRecordInfo-84C0ABB4AA30	58690282	Acquirer2	706728	PSP3	M748857	Merchant30	S30486452156990	Store35	5399	24231686	HKG	RedactedCity-9C6867C77D8F	2028-07-15T16:18:14+08:00	2028-07-15T16:18:14+08:00	2028-07-15T16:18:14+08:00	Payment	Mastercard	4669408210815845735306394	5171324158317610038988321	1009923278643856151951	5131PEKKJSOHL	489932******2400	Debit	MDS	Consumer	NGA	504.59	504.59	HKD	504.59	HKD	06	Cybersource	Success	004416	International	10830822275593064918940	20280728			504.70	HKD	-8.08	496.62
20280729	PSP-First ChargeBack	Full	7732075677	13.7	RedactedRecordInfo-FAB20E45FCE7	58690282	Acquirer2	648654	PSP11	M748857	Merchant30	S56664184318130	Store45	5816	24231686	HKG	RedactedCity-9C6867C77D8F	2028-07-03T18:12:02+08:00	2028-07-03T18:12:02+08:00	2028-07-03T18:12:02+08:00	Payment	Visa	9215225894778977574582241	4393399781277320311486457	5472946178067841076730	760067204391482	624642******1055	Debit	F	Consumer	CAN	91.22	91.22	CAD	91.22	CAD	05	Cybersource	Success	945745	International	85906447517378074241837	20280728	-91.22	CAD	-64.84	USD	1.037474	-63.80
20280729	PSP-First ChargeBack	Full	8097187217	10.4	RedactedRecordInfo-CB10D4498C2E	58690282	Acquirer2	648654	PSP11	M748857	Merchant30	S17332853592011	Store47	5817	24231686	HKG	RedactedCity-B1549BB5014B	2028-06-24T14:53:37+08:00	2028-06-24T14:53:37+08:00	2028-06-24T14:53:37+08:00	Payment	Visa	7132643577762704399335094	3279671681711641095382904	6100995613088524716275	428991064909643	304422******8132	Credit	C	Consumer	TWN	2280.89	2280.89	TWD	2280.89	TWD	07	Cybersource	Success	395844	International	63568863308948660793503	20280728	-2280.89	TWD	-70.60	USD	1.452986	-69.15

File-05 PSP_Miscellaneous_Detail 渠道清算异常及特殊交易流水明细文件

Overview#

文件位置和命名规则#

文件层级与文件代码#

文件名称字段说明#

文件名示例#

SFTP 路径与登录#

Report structure#

文件基本属性#

文件生成时间#

File data elements#

Samples#