Evo Payment 对账文件&规范
    • Overview
    • 对账文件
      • File-01 Activity_Detail 联机交易流水明细文件
      • File-02 Settlement_Detail 清算交易流水明细文件
      • File-03 Miscellaneous_Detail 清算手工交易流水明细文件
      • File-04 PSP_Reconciliation_Detail 渠道清算对账流水明细文件
      • File-05 PSP_Miscellaneous_Detail 渠道清算异常及特殊交易流水明细文件
      • File-06 Interchange_Scheme_Fee_Detail IC费和Scheme费明细文件
      • File-07 PSP_Interchange_Scheme_Fee_Detail 渠道IC费和Scheme费明细文件
      • File-08 Network_Token_Cryptogram_Detail 网络令牌密文明细文件
    • 卡BIN文件
      • BIN File

    Overview

    Evo Payment 清分清算系统提供批量对账流水文件数据，以帮助接入方进行内部交易数据勾对、差错处理和渠道对账等内部清分对账操作处理。接入方可通过 Evo Payment G2 服务平台下载或通过 SFTP 方式获取对账数据，并据此完成自动化对账与日常运营核对。

    基本概念#

    本节介绍 Evo Payment 对账文档中使用的基本概念。

    交易明细数据文件#

    交易明细数据文件是供接入方系统处理的一种数据格式文件，主要用于接入方进行内部系统自动化交易勾对以及自动化对账处理。文件按日切时间点产出前一自然日日切周期内的全部联机交易流水明细，包含各种交易状态下的全部交易类型（含失败状态交易）。
    Note : 若前一日商户未产生联机交易，则 Evo Payment 仍会产出空文件，仅保留文件中的字段名称以及结束标识（***END***）。

    对账报表数据文件#

    对账报表数据文件是供接入方运营人员日常对账使用的可读报表文件，主要用于接入方运营、争议、差错等日常数据核对。

    卡 BIN 文件#

    除交易明细与对账报表外，Evo Payment 同时支持卡 BIN 文件的获取，供接入方在风控、路由、汇率等场景中查询使用。

    文件层级#

    根据 Evo Payment 系统配置，对账文件可按以下层级产出不同维度的明细数据：
    1.
    机构层级（Acquirer）
    2.
    集团层级（Group）
    3.
    商户层级（Merchant）
    4.
    门店层级（Store）

    周期#

    Evo Payment 清分清算系统以自然日为基本对账周期。每周一至周日产出对应的日切对账文件，每日 10:00–12:00 AM（Evo Payment 节点系统时间）生成。

    对账文件#

    本节提供 Evo Payment 对账文件的清单、生成时间与下载方式。

    对账文件清单与对账用途#

    Evo Payment 对账文件包含交易明细数据文件与对账报表数据文件。下列表格说明各文件的用途：
    交易明细数据文件
    名称描述用途
    File-01 Activity_Detail 联机交易流水明细文件接入方业务周期内全部联机交易流水的明细数据，按日切时间点产出用于接入方系统按商户交易号或Evo Payment 交易号逐笔勾对本方订单，核对交易金额、币种、汇率、交易状态与系统/渠道应答码等信息，并通过原交易号关联退款、撤销等后续交易，作为自动化交易勾对与自动化对账的基准数据
    File-02 Settlement_Detail 清算交易流水明细文件接入方业务周期内参与清算的流水明细数据，按日切时间点产出用于核对清算周期内每笔参与清算的交易的交易金额、清算金额与清算币种、清算汇率，以及 MDR 计费规则与手续费、IC 费、卡组织费、收单服务费、增值税/预提税等各项费用和商户清算净金额，据此确认商户结算入账
    File-03 Miscellaneous_Detail 清算手工交易流水明细文件接入方业务周期内参与清算的手工类或特殊清算的交易流水明细数据，按日切时间点产出用于核对清算周期内非交易类记录与手工发起的特殊清算记录，依据记录日期、记录类型、记录理由码与记录参考号定位来源，核对其清算金额、手续费、税费与清算净金额对商户结算的影响
    File-04 PSP_Reconciliation Detail 渠道清算对账流水明细文件接入方业务周期内渠道清算与 Evo Payment 系统勾对成功的流水明细数据，按日切时间点产出用于与渠道（PSP）清算数据逐笔勾对，核对每笔交易的 PSP 清算日期、清算金额与币种、清算汇率、优惠金额、IC 手续费、增值税/预扣税及清算净金额，确认渠道侧入账与系统记账一致
    File-05 PSP_Miscellaneous_Detail 渠道清算异常及特殊交易流水明细文件接入方业务周期内渠道清算的异常以及特殊清算交易流水明细数据，按日切时间点产出用于核对渠道清算中未能正常勾对的异常记录以及争议、调整等特殊清算记录，依据记录类型、记录理由码与记录参考号进行差错处理和争议核对
    File-06 Interchange_Scheme_Fee_Detail IC 费和 Scheme 费明细文件接入方业务周期内 Visa 和 Mastercard 的 Interchange 费和卡组织费用数据，按日切时间点产出用于逐笔核对 Evo Payment 侧计算的 Interchange 费与 Scheme 费，校验费项名称、费用代码与计费规则的适用是否正确，支撑交易成本核算与商户定价复核
    File-07 PSP_Interchange_Scheme_Fee_Detail 渠道 IC 费和 Scheme 费明细文件接入方业务周期内 Visa 和 Mastercard 渠道清算的 Interchange 费和卡组织费用数据，按日切时间点产出用于将渠道清算返回的 Interchange 费与 Scheme 费同 Evo Payment 侧计算结果（File-06）逐笔比对，核查渠道计费规则与费用差异
    File-08 Network_Token_Cryptogram_Detail 网络令牌密文明细文件接入方业务周期内 Cryptogram 生成密文并用于 Network Token支付的明细数据，按日切时间点产出用于核对通过 Network Token 与 Cryptogram 完成的交易，依据令牌号、令牌唯一参考号、支付账户参考（PAR）与认证类型、认证标识勾对令牌与卡片的对应关系，支撑令牌交易对账与问题排查
    Note :
    文件统一使用 UTF-8 带 BOM 编码；
    文件以 CSV 格式提供，字段分隔符为 ","（双引号 + 英文逗号）；
    文件内容以换行符 \n（0x0A）作为行结束；
    文件内容最后一行以 ***END*** 作为内容结束标识；

    对账文件下载#

    接入方可通过以下两种方式获取对账文件：

    Evo Payment 服务平台#

    接入方可登录 Evo Payment 服务平台直接下载对账文件。

    SFTP#

    默认目录：Evo Payment 作为 SFTP Server，地址为 /in/{YYYYMMDD}；
    登录方式：公私钥认证；
    传输完成标识：Evo Payment 在文件传输至 SFTP 目录结束后，会额外生成与对账文件同名的 .ok 后缀 TXT 文本格式空文件（例如 Acquirer_Activity_Detail_P003_88888888_20230108.csv.ok），用于标识该文件传输完成。
    Important : 客户端在解析对账文件前，应先判断同名 .ok 文件是否已存在，以避免读取到尚未传输完成的文件。

    如何进行对账#

    接入方需记录自身交易数据，并与 Evo Payment 提供的对账文件进行勾对。建议流程：
    1.
    每日定时从 G2 平台或 SFTP 拉取对账文件；
    2.
    检查同名 .ok 标识文件确认传输完成；
    3.
    按统一规则解析 CSV 文件（UTF-8 BOM、双引号 + 逗号分隔、***END*** 结束）；
    4.
    以 Evo Payment 提供的交易明细数据文件为准进行自动化对账；
    5.
    差异记录进入差错处理流程，并通过人工核对与运营报表完成确认。

    了解更多#

    版本与兼容性#

    文件版本号按 P/T + 3 位数字 命名，新版本文件兼容旧版本字段；

    大文件拆分#

    Evo Payment 支持配置单份文件最大记录数量
    主要作用：可配置单份文件最大记录数量阈值，同一日切周期内如果超过该阈值文件将分批生成。
    场景1：设置10000阈值，交易数量15000，会生成二个文件
    场景2：设置10000阈值，交易数量30000，会生成三个文件
    开启大文件拆分功能后，文件名称中会增加 BatchNum（001–999）后缀。报表名称示例：如Acquirer_Activity_Detail_(Version No)_(Inscode)_YYYYMMDD_(BatchNum)
    下一页
    File-01 Activity_Detail 联机交易流水明细文件
    Built with