Evo Payment 对账文件&规范
  1. 对账文件
  • 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
  1. 对账文件

File-03 Miscellaneous_Detail 清算手工交易流水明细文件

Overview#

Evo Payment 清分清算系统按照客户指定的日切时间点，产出前一自然日日切周期内的全部清算手工交易流水明细文件，供客户进行自动化交易勾对与对账处理。
Note :
文件包含全部交易状态的联机交易（含失败状态交易）；
若前一日客户未产生联机交易，则产出空文件，仅保留字段名称及结束标识 END；
开启大文件拆分功能后，文件名称中会增加 BatchNum（001–999）后缀。

文件位置和命名规则#

文件层级与文件代码#

Evo Payment 可根据客户在系统中配置的不同层级产出不同维度明细。文件代码及报表名称按层级区分如下：
文件层级文件代码报表名称模板
机构层级A-File-03Acquirer_Miscellaneous_Detail_(Version No)_(Inscode)_YYYYMMDD
集团层级G-File-03Group_Miscellaneous_Detail_(Version No)_(Groupcode)_YYYYMMDD
商户层级M-File-03Merchant_Miscellaneous_Detail_(Version No)_(Merchantcode)_YYYYMMDD
门店层级S-File-03Store_Miscellaneous_Detail_(Version No)_(Storecode)_YYYYMMDD

文件名称字段说明#

每个字段使用下划线（_）连接，字段含义如下：
字段说明
固定值Acquirer_Miscellaneous_Detail / Group_Miscellaneous_Detail / Merchant_Miscellaneous_Detail / Store_Miscellaneous_Detail，对应该层级
版本号第一位为文件标识：P 生产环境、T 测试环境；后三位为数字编号，从 001 起至最大 999（新版本兼容旧版本）
Inscode/Groupcode/Merchantcode/Storecode客户的机构、集团、商户或门店标识符
日期YYYYMMDD，报表生成日期
批次号（可选）当机构文件配置 Batch Generate Threshold 功能时增加，取值范围 001–999

文件名示例#

生产环境（机构层级）
Acquirer_Miscellaneous_Detail_P003_88888888_20230108.csv
测试环境（机构层级）
Acquirer_Miscellaneous_Detail_T003_88888888_20230108.csv
带批次号（机构层级）
Acquirer_Miscellaneous_Detail_P003_88888888_20230108_001.csv

SFTP 路径与登录#

项说明
SFTP 模式Evo Payment 为 SFTP Server
默认目录/in/{YYYYMMDD}
登录方式公私钥
传输完成标识同名 .ok 后缀 TXT 空文件（如 Acquirer_Miscellaneous_Detail_P003_88888888_20230108.csv.ok）
Important : 客户端在拉取并解析对账文件前，应先检查同名 .ok 文件是否存在，以确认 Evo Payment 已完成文件传输。

Report structure#

文件基本属性#

属性值
文件格式CSV
文件编码UTF-8 带 BOM
换行符\n（0x0A）
字段分隔符双引号 + 英文逗号 ","
文件内容结束标识***END***（最后一行）

文件生成时间#

生成周期：自然日文件，每周一至周日产出
生成时间：每日 10:00–12:00 AM（Evo Payment 节点系统时间）

File data elements#

本节定义 File-03 Miscellaneous_Detail 文件的字段要素。
序号字段名称中文释义
1Record Date记录日期
2Record Type记录类型
3Record Reference Number记录参考号
4Record Reason Code记录理由码
5Record Reference Information记录参考信息
6PSP ID支付 PSP ID
仅在机构层级文件中出现
7PSP Name支付 PSP 名称
仅在机构层级文件中出现
8Group ID集团号
仅在机构和集团层级文件中出现
9Group Name集团名称
仅在机构和集团层级文件中出现
10Merchant ID商户号
仅在机构、集团和商户层级文件中出现
11Merchant Name商户名称
仅在机构、集团和商户层级文件中出现
12Store ID门店号
13Store Name门店名称
14Store MCC门店 MCC
15Terminal ID终端号
16Merchant Nation商户国家
17Merchant City商户城市
18Merchant Txn Time商户交易时间
19System Txn TimeEvo Payment 系统交易时间
20Txn Pay TimePSP 交易时间
21API TypeAPI 类别
22Txn Type交易类型
23Payment Brand支付品牌
24Payment Method Variant付款方式
25Merchant Txn ID商户交易号
26Merchant Order Reference商户订单参考信息
27System Txn IDEvo Payment 交易号
28PSP Txn IDPSP 交易号
29Original Merchant Txn ID原交易商户交易号
30Original System Txn ID原 Evo Payment 交易号
31Original PSP Txn ID原交易 PSP 交易号
32Card Number卡号（前6******后4）
33Funding Type卡借贷记标识
34Product ID卡产品标识
35Product Type ID卡类别标识
36Issuer Country发卡国家
37Merchant Local Amt商户本地金额
38Local Tips Amt小费本地金额
39Local Surcharge Fee Amt额外服务费本地金额
40Local Capture Amt商户确认本地金额
41Merchant Local Curr商户本地币种
42Rate of Local to TxnMCP/DCC 汇率
43Merchant Txn Amt商户交易金额
44Tips Amount小费交易金额
45Surcharge Fee Amt额外服务费用金额
46Merchant Capture Amt商户确认金额
47Merchant Txn Curr商户交易币种
48User Billing Amt用户扣账金额
49User Billing Curr用户扣账币种
50ECI认证标识
51Txn Initiation Mode交易发起方式
52LinkPay Order IDLinkPay 订单号
53Txn StatusEvo Payment 系统交易状态
54System Result CodeEvo Payment 返回应答码
55PSP Result CodePSP 渠道应答码
56PSP Authorization CodePSP 渠道授权码
57Crossborder Flag跨区标识
58Merchant Sttl Amt商户清算金额
59Merchant Discount Amt商户优惠金额
60Merchant Sttl Curr商户清算币种
61Rate from Merchant Txn to Sttl商户清算汇率
62MDR Rules商户手续费计费规则
63MDR Amount商户清算手续费
64PSP Interchange Fee发卡行交换费（IC）
65PSP Scheme Fee卡组织手续费（+）
66Acquirer Service Fee收单服务费（+）
67Txn Service Fee商户交易手续费
68VAT Amount增值税费金额
69WHT Amount预提税费金额
70Net Merchant Sttl Amt商户清算净金额
71Metadata备注信息

Samples#

Record DateRecord TypeRecord Reference NumberRecord Reason CodeRecord Reference InformationPSP IDPSP NameGroup IDGroup NameMerchant IDMerchant NameStore IDStore NameStore MCCTerminal IDMerchant NationMerchant CityMerchant Txn TimeSystem Txn TimeTxn Pay TimeAPI TypeTxn TypePayment BrandPayment Method VariantMerchant Txn IDMerchant Order ReferenceSystem Txn IDPSP Txn IDOriginal Merchant Txn IDOriginal System Txn IDOriginal PSP Txn IDCard NumberFunding TypeProduct IDProduct Type IDIssuer CountryMerchant Local AmtLocal Tips AmtLocal Surcharge Fee AmtLocal Capture AmtMerchant Local CurrRate of Local to TxnMerchant Txn AmtTips AmountSurcharge Fee AmtMerchant Capture AmtMerchant Txn CurrUser Billing AmtUser Billing CurrECITxn Initiation ModeLinkPay Order IDTxn StatusSystem Result CodePSP Result CodePSP Authorization CodeCrossborder FlagMerchant Sttl AmtMerchant Discount AmtMerchant Sttl CurrRate from Merchant Txn to SttlMDR RulesMDR AmountPSP Interchange FeePSP Scheme FeeAcquirer Service FeeTxn Service FeeVAT AmountWHT AmountNet Merchant Sttl AmtMetadata
20280729Merchant Deposit-Collect98306850823657-139-1l208912r3sz9i01m1RedactedRecordInfo-F0DD3E6B4169A694982Group7M735816Merchant24S002072Store275621HKGRedactedCity-062235E8EC8D2028-07-29T10:22:37+08:002028-07-29T10:22:37+08:00Deposit Collection59598400788582-783-7c211b560o5t89n9275w8yr6402oh2vy06054267758272-530-3i144191d1tk945946998309048-925-op01mi36wi3n1l0366461386e91r52zi-1112.96USDInternational-1112.96USDCombination0.00-1112.96
20280729Merchant Risk-Hold41547545885472-875-p4136470qdg60n2k76RedactedRecordInfo-CCABABCCD752A399378Group8M392761Merchant25S123017Store285816HKGRedactedCity-9C6867C77D8F2028-07-29T10:22:32+08:002028-07-29T10:22:32+08:00Risk Hold59606066635182-445-96h5859x25s02715ato6ho366r6d399d85308433419762-394-i0183545plu2839788746004466-194-0w727amy0u4718e523q6vx3d81161656-0.25USDInternational-0.25USDCombination0.00-0.25
20280729Merchant Deposit-Return91548135543102-O500468-782-725451206uz108ow7uRedactedRecordInfo-C66D69338BA2A399378Group8M392761Merchant25S123017Store285816HKGRedactedCity-9C6867C77D8F2028-07-29T10:22:38+08:002028-07-29T10:22:38+08:00Deposit Return96075908025646-Q143651-788-i537yn5br8073n8p2j22b754q160xv3r65371034888927-D049640-450-6335267538273639558-R007848-501-0y0x4j7q38y284flgeaz854c2u730r621080.06USDInternational1080.06USDCombination0.001080.06
20280729Merchant Risk-Release56194276313042-F122747-823-r24999e010291230gnRedactedRecordInfo-D2202B0441CFA482660Group4M505070Merchant26S434840Store297399HKGRedactedCity-9C6867C77D8F2028-07-29T10:22:38+08:002028-07-29T10:22:38+08:00Risk Release79152186849947-H595639-918-n70f942zirn61154j19173s00nr3831073027676410762-H606948-895-z189353697806686894-Y902060-585-h33293x8is3a10m3p3c78ef4o404x0860.65USDInternational0.65USDCombination0.000.65
20280729Merchant Fee-CreditGU54643334429960VpRedactedRecordInfo-FC5201E9D9B6evonetPSP9A482660Group3M563769Merchant7S977122Store75816HKGRedactedCity-062235E8EC8D2028-07-29T10:22:21+08:002028-07-29T10:22:21+08:00RefundVisaJH15544613507787Io92754643466570NG88895664432412Ma08803246923815HE13604085177223Tu04351238555695JZQM536585895653899770983sye3nmk-309722446714124141657724688354449843236654119.26USDInternational19.26USDCombination0.0019.26
20280729Merchant Dispute-Debit17874055014311299056332678536PSP3A694982Group7M659658Merchant27S700722Store305621HKGRedactedCity-9C6867C77D8F2028-07-20T09:31:18+08:002028-07-28T10:17:47+08:00ChargebackMastercardBE6493389369337016Y1440965162496517325657BFK028GF82395wuw-6013872147621989613161111436354533******847552.93USD-76.01AUDsuccess773492International-52.93USDCombination0.00-52.93
20280729Merchant Fee-Debit4534249873618331732746574188768PSP10A694982Group7M566071Merchant28S030051Store315621HKGRedactedCity-9C6867C77D8F2028-07-01T14:23:54+08:002028-07-28T10:17:47+08:00Installation FeeJCBPO9481202542002589B7289468674292692726187469655829216aek-0322739639111472479166340594510563******8955551.62USDsuccess716877International-551.62USDCombination0.00-551.62
20280729Merchant Dispute-CreditGU54643334429960VpRedactedRecordInfo-FC5201E9D9B6evonetPSP9A482660Group3M563769Merchant7S977122Store75816HKGRedactedCity-062235E8EC8D2028-07-29T10:22:21+08:002028-07-29T10:22:21+08:00Reversal of ChargebackVisaJH15544613507787Io92754643466570NG88895664432412Ma08803246923815HE13604085177223Tu04351238555695JZQM536585895653899770983sye3nmk-309722446714124141657724688354449843236654119.26USDInternational19.26USDCombination0.0019.26
上一页
File-02 Settlement_Detail 清算交易流水明细文件
下一页
File-04 PSP_Reconciliation_Detail 渠道清算对账流水明细文件
Built with