Overview

At the customer-specified daily cut-off time, the Evo Payment clearing and settlement system produces a detail file containing all PSP interchange fees and scheme fees within the previous natural-day cut-off cycle, for customers to perform automated transaction matching and reconciliation.

Note :

The file contains online transactions in all transaction statuses (including transactions with a failed status);

If the customer generated no online transactions on the previous day, an empty file is generated, retaining only the field names and end marker END;

After the large-file splitting function is enabled, a BatchNum (001–999) suffix is added to the file name.

File location and naming rules

File levels and file codes

Evo Payment can produce details in different dimensions according to the different levels configured for the customer in the system. File codes and report names are distinguished by level as follows:

File level	File code	Report name template
Acquirer level	A-File-07	`Acquirer_PSP_Interchange_Scheme_Fee_Detail_(Version No)_(Inscode)_YYYYMMDD`

File name field descriptions

Each field is connected by an underscore (_), and the field meanings are as follows:

Field	Description
Fixed value	`Acquirer_PSP_Interchange_Scheme_Fee_Detail`, corresponding to that level
Version number	The first character is the file identifier: `P` production environment, `T` test environment; the last three characters are a numeric number, starting from `001` up to a maximum of `999` (new versions are compatible with old versions)
Inscode/Groupcode/Merchantcode/Storecode	The customer's Acquirer, Group, Merchant, or Store identifier
Date	`YYYYMMDD`, report generation date
Batch number (optional)	Added when the `Batch Generate Threshold` function is configured for the Acquirer file, with a range of `001`–`999`

File name examples

Production environment (Acquirer level)

Acquirer_PSP_Interchange_Scheme_Fee_Detail_P003_88888888_20230108.csv

Test environment (Acquirer level)

Acquirer_PSP_Interchange_Scheme_Fee_Detail_T003_88888888_20230108.csv

With batch number (Acquirer level)

Acquirer_PSP_Interchange_Scheme_Fee_Detail_P003_88888888_20230108_001.csv

Item	Description
SFTP mode	Evo Payment is the SFTP Server
Default directory	`/in/{YYYYMMDD}`
Login method	Public/private key
Transfer completion marker	Empty TXT file with the same-name `.ok` suffix (e.g., `Acquirer_PSP_Interchange_Scheme_Fee_Detail_P003_88888888_20230108.csv.ok`)

Important : Before pulling and parsing the reconciliation file, the client should first check whether the same-name .ok file exists to confirm that Evo Payment has completed the file transfer.

Report structure

Basic file attributes

Attribute	Value
File format	CSV
File encoding	UTF-8 with BOM
Line break	`\n` (`0x0A`)
Field delimiter	Double quotation marks + comma `","`
File content end marker	`*END*` (last line)

File generation time

Generation cycle: natural-day file, produced Monday through Sunday each week

Generation time: daily 10:00–12:00 AM (Evo Payment node system time)

File data elements

This section defines the field elements of the File-07 PSP_Interchange_Scheme_Fee_Detail file.

No.	Field name	Description
1	Acquirer ID	Acquirer ID Appears only in Acquirer-level files
2	PSP ID	Payment PSP ID Appears only in Acquirer-level files
3	Group ID	Group number Appears only in Acquirer-level files
4	Merchant ID	Merchant number Appears only in Acquirer-level files
5	Store ID	Store number Appears only in Acquirer-level files
6	Merchant Txn ID	Merchant transaction number Appears only in Acquirer-level files
7	Merchant Order Reference	Merchant order reference information Appears only in Acquirer-level files
8	System Txn ID	Evo Payment transaction number Appears only in Acquirer-level files
9	PSP Txn ID	PSP transaction number Appears only in Acquirer-level files
10	Original Merchant Txn ID	Original Merchant transaction number Appears only in Acquirer-level files
11	Original PSP Txn ID	Original PSP transaction number Appears only in Acquirer-level files
12	Merchant Txn Time	Merchant transaction time Appears only in Acquirer-level files
13	Payment Brand	Payment brand Appears only in Acquirer-level files
14	Txn Type	Transaction type Appears only in Acquirer-level files
15	PSP MCC	PSP's MCC, Merchant category Appears only in Acquirer-level files
16	Txn Status	Evo Payment system transaction status Appears only in Acquirer-level files
17	Merchant Txn Amt	Merchant transaction amount Appears only in Acquirer-level files
18	Merchant Txn Curr	Merchant transaction currency Appears only in Acquirer-level files
19	Funding Type	Card debit/credit indicator Appears only in Acquirer-level files
20	Card Program ID	CPI identifier. Applicable only to Mastercard; current values include MCC and DMC. Appears only in Acquirer-level files
21	Product ID	Card product ID Appears only in Acquirer-level files
22	Product Type ID	Card category identifier Appears only in Acquirer-level files
23	Issuer Country	Issuer country/region Appears only in Acquirer-level files
24	Acquirer Nation	Country/region where the Acquirer is located Appears only in Acquirer-level files
25	Merchant Nation	Country/region where the Merchant is registered Appears only in Acquirer-level files
26	Crossborder Flag	Cross-region indicator Appears only in Acquirer-level files
27	Payment Scenario	Transaction scenario: online/offline Appears only in Acquirer-level files
28	IC Fee	Interchange fee identifier, fixed value: Interchange Fee Appears only in Acquirer-level files
29	IC Fee Indicator	Card scheme Interchange Fee ID Appears only in Acquirer-level files
30	IC Fee Name	Interchange fee name Appears only in Acquirer-level files
31	IC Fee Rule Flag	Interchange fee rule identifier, with values and meanings shown below. Appears only in Acquirer-level files
32	IC Fee Rule	Interchange fee rule Appears only in Acquirer-level files
33	Scheme Fee	Scheme fee identifier, fixed value: Scheme Fee Appears only in Acquirer-level files
34	Scheme Fee Service Code	Scheme fee code Appears only in Acquirer-level files
35	Scheme Fee Name	Scheme fee item name Appears only in Acquirer-level files
36	Scheme Fee Rule Flag	Scheme fee rule identifier Appears only in Acquirer-level files
37	Scheme Fee Rule	Scheme fee rule Appears only in Acquirer-level files
38	Scheme Fee Service Code, Scheme Fee Name, Scheme Fee Rule Flag，Scheme Fee Rule	Repeats sequentially as a group Appears only in Acquirer-level files

Samples

The viewer below shows the content of the sample file. Click Download to get the file.

File-07 PSP_Interchange_Scheme_Fee_Detail PSP Interchange and Scheme Fee Detail File

Overview#

File location and naming rules#

File levels and file codes#

File name field descriptions#

File name examples#

SFTP path and login#

Report structure#

Basic file attributes#

File generation time#

File data elements#

Samples#