Overview

Evo Payment 清分清算系统在交易明细报表之外，另提供一份展示对应卡 BIN 信息的表格文件，供客户查询卡品牌、卡号区间、发卡行等卡 BIN 属性。

Note :

仅支持机构层级配置使用，不提供集团、商户、门店层级；

文件按月产出，不随日切周期产出；

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

开启 PSP 维度报表功能后，文件名称中会增加 PSPName 后缀；两项同时开启时，PSPName 在 BatchNum 之前。

文件位置和命名规则

文件层级与文件代码

卡 BIN 文件仅支持机构层级，不区分其他维度。

文件层级	文件代码	报表名称模板
机构层级	BIN-File	`BIN_File_{Version No}_{Acquirer ID}_YYYYMMDD`

文件名称字段说明

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

字段	说明
固定值	`BIN_File`
版本号	第一位为文件标识：`P` 生产环境、`T` 测试环境；后三位为数字编号，从 `001` 起至最大 `999`（新版本兼容旧版本）
Acquirer ID	客户的机构标识符
日期	`YYYYMMDD`，报表生成日期
PSP 名称（可选）	当机构文件配置 `PSP Dimension Report` 功能时增加，取 PSP 名称
批次号（可选）	当机构文件配置 `Batch Generate Threshold` 功能时增加，取值范围 `001`–`999`

文件名示例

生产环境（机构层级）

BIN_File_P001_88888888_20240430.csv.zip

测试环境（机构层级）

BIN_File_T001_88888888_20240430.csv.zip

带批次号

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

带 PSP 名称

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

PSP 名称与批次号同时使用

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

获取方式

方式	说明
平台下载	Evo Payment G2 服务平台
SFTP 传输	见下方 SFTP 路径与登录
API 获取	通过接口拉取

SFTP 路径与登录

项	说明
SFTP 模式	Evo Payment 为 SFTP Server
默认目录	`/in/{YYYYMMDD}`
登录方式	公私钥
传输完成标识	同名 `.ok` 后缀 TXT 空文件（如 `BIN_File_P001_88888888_20240430.csv.ok`）

Important : 客户端在拉取并解析卡 BIN 文件前，应先检查同名 .ok 文件是否存在，以确认 Evo Payment 已完成文件传输。

Report structure

文件基本属性

属性	值
文件格式	CSV，压缩为 `.zip` 下发
文件编码	规范未定义；实测无 BOM
换行符	规范未定义；实测 `\n`（`0x0A`）
字段分隔符	规范未定义；实测英文逗号 `,`，字段未统一加双引号
文件内容结束标识	规范未定义；实测最后一行为 `*END*`

文件生成时间

生成周期：月度文件，每月 2 号产出

生成时间：每月 2 号上午 10:00–12:00（Evo Payment 节点系统时间）

File data elements

本节定义 BIN File 文件的字段要素。以下 14 个字段在机构层级文件中全部出现。

序号	字段名称	中文释义
1	cardBrand	卡品牌
2	issAccRangeLow	卡号区间最小值
3	issAccRangeHigh	卡号区间最大值
4	cardLength	卡号长度
5	countryCode	国家代码
6	currency	币种
7	creditFlag	借贷记标识
8	productID	卡产品 ID
9	productType	卡产品种类
10	issuerIIC	发卡行代码
11	issuerName	发卡行名称
12	createTime	创建时间（卡 BIN 文件更新的时间）
13	dccFlag	DCC 标识
14	3dsFlag	3DS 标识

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#

文件位置和命名规则#

文件层级与文件代码#

文件名称字段说明#

文件名示例#

获取方式#

SFTP 路径与登录#

Report structure#

文件基本属性#

文件生成时间#

File data elements#

Samples#