Overview

At the customer-specified daily cut-off time, the Evo Payment clearing and settlement system produces a detail file containing all 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-06	`Acquirer_Interchange_Scheme_Fee_Detail_(Version No)_(Inscode)_YYYYMMDD`
Group level	G-File-06	`Group_Interchange_Scheme_Fee_Detail_(Version No)_(Groupcode)_YYYYMMDD`
Merchant level	M-File-06	`Merchant_Interchange_Scheme_Fee_Detail_(Version No)_(Merchantcode)_YYYYMMDD`
Store level	S-File-06	`Store_Interchange_Scheme_Fee_Detail_(Version No)_(Storecode)_YYYYMMDD`

File name field descriptions

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

Field	Description
Fixed value	`Acquirer_Interchange_Scheme_Fee_Detail` / `Group_Interchange_Scheme_Fee_Detail` / `Merchant_Interchange_Scheme_Fee_Detail` / `Store_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_Interchange_Scheme_Fee_Detail_P003_88888888_20230108.csv

Test environment (Acquirer level)

Acquirer_Interchange_Scheme_Fee_Detail_T003_88888888_20230108.csv

With batch number (Acquirer level)

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

Samples

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

File-06 Interchange_Scheme_Fee_Detail 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#