Overview

In addition to transaction detail reports, the Evo Payment clearing and settlement system also provides a table file showing the corresponding card BIN information, for customers to query card brand, card number range, issuing bank, and other card BIN attributes.

Note :

Only Acquirer-level configuration is supported; Group, Merchant, and Store levels are not provided;

The file is generated monthly and is not generated with the daily cutoff cycle;

After the large-file splitting feature is enabled, the file name will include a BatchNum (001–999) suffix;

After the PSP dimension report feature is enabled, the file name will include a PSPName suffix; when both features are enabled, PSPName precedes BatchNum.

File location and naming rules

File levels and file codes

The Card BIN File supports only the Acquirer level and does not distinguish other dimensions.

File level	File code	Report name template
Acquirer level	BIN-File	`BIN_File_{Version No}_{Acquirer ID}_YYYYMMDD`

File name field descriptions

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

Field	Description
Fixed value	`BIN_File`
Version number	The first character is the file identifier: `P` for the production environment and `T` for the test environment; the last three characters are a numeric number, from `001` to a maximum of `999` (new versions are compatible with old versions)
Acquirer ID	The customer's Acquirer identifier
Date	`YYYYMMDD`, the report generation date
PSP name (optional)	Added when the Acquirer file is configured with the `PSP Dimension Report` feature, using the PSP name
Batch number (optional)	Added when the Acquirer file is configured with the `Batch Generate Threshold` feature, with a value range of `001`–`999`

File name examples

Production environment (Acquirer level)

BIN_File_P001_88888888_20240430.csv.zip

Test environment (Acquirer level)

BIN_File_T001_88888888_20240430.csv.zip

With batch number

BIN_File_{Version No}_{Acquirer ID}_YYYYMMDD_(BatchNum)

With PSP name

BIN_File_{Version No}_{Acquirer ID}_YYYYMMDD_(PSPName)

When PSP name and batch number are used together

BIN_File_{Version No}_{Acquirer ID}_YYYYMMDD_(PSPName)_(BatchNum)

Retrieval methods

Method	Description
Platform download	Evo Payment G2 service platform
SFTP transfer	See the SFTP path and login below
API retrieval	Pull through the API

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. `BIN_File_P001_88888888_20240430.csv.ok`)

Important : Before pulling and parsing the Card BIN 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 properties

Property	Value
File format	CSV, delivered compressed as `.zip`
File encoding	Not defined in the specification; observed without BOM
Line break	Not defined in the specification; observed as `\n` (`0x0A`)
Field delimiter	Not defined in the specification; observed as comma `,`, with fields not uniformly enclosed in double quotes
File content end marker	Not defined in the specification; observed with `*END*` as the last line

File generation time

Generation cycle: monthly file, generated on the 2nd of each month

Generation time: on the 2nd of each month, 10:00–12:00 AM (Evo Payment node system time)

File data elements

This section defines the data elements of the BIN File. All of the following 14 fields appear in the Acquirer-level file.

No.	Field name	Description
1	cardBrand	Card brand
2	issAccRangeLow	Minimum card number range value
3	issAccRangeHigh	Maximum card number range value
4	cardLength	Card number length
5	countryCode	Country code
6	currency	Currency
7	creditFlag	Debit/credit indicator
8	productID	Card product ID
9	productType	Card product type
10	issuerIIC	Issuer code
11	issuerName	Issuer name
12	createTime	Creation time (time when the Card BIN File is updated)
13	dccFlag	DCC indicator
14	3dsFlag	3DS indicator

Samples

cardBrand	issAccRangeLow	issAccRangeHigh	cardLength	countryCode	currency	creditFlag	ProductID	productType	issuerIIC	issuerName	createTime	dccFlag	3dsFlag
MCC	5102464090000000000	5102464109999999999	16	IRL	TWD	C	MBI	Commercial	00000026414	CHASE PAYMENTECH EUROPE LIMITE	2026-04-18T07:35:25Z		Y
VIS	4999760180000000000	4999760189999999999	16	USA	USD	C	A	Consumer	499976	NEW PEOPLES BANK, INC.	2026-07-28T07:31:48Z	Y

BIN File

Overview#

File location and naming rules#

File levels and file codes#

File name field descriptions#

File name examples#

Retrieval methods#

SFTP path and login#

Report structure#

Basic file properties#

File generation time#

File data elements#

Samples#