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-04 PSP_Reconciliation_Detail 渠道清算对账流水明细文件

Overview#

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

文件位置和命名规则#

文件层级与文件代码#

Evo Payment 可根据客户在系统中配置的不同层级产出不同维度明细。文件代码及报表名称按层级区分如下:
文件层级文件代码报表名称模板
机构层级A-File-04Acquirer_PSP_Reconciliation_Detail_(Version No)_(Inscode)_YYYYMMDD

文件名称字段说明#

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

文件名示例#

生产环境(机构层级)
Acquirer_PSP_Reconciliation_Detail_P003_88888888_20230108.csv
测试环境(机构层级)
Acquirer_PSP_Reconciliation_Detail_T003_88888888_20230108.csv
带批次号(机构层级)
Acquirer_PSP_Reconciliation_Detail_P003_88888888_20230108_001.csv

SFTP 路径与登录#

项说明
SFTP 模式Evo Payment 为 SFTP Server
默认目录/in/{YYYYMMDD}
登录方式公私钥
传输完成标识同名 .ok 后缀 TXT 空文件(如 Acquirer_PSP_Reconciliation_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-04 PSP_Reconciliation_Detail 文件的字段要素。
序号字段名称中文释义
1Acquirer ID机构 ID
仅在机构层级文件中出现
2Acquirer Name机构名称
仅在机构层级文件中出现
3PSP ID支付 PSP ID
仅在机构层级文件中出现
4PSP Name支付 PSP 名称
仅在机构层级文件中出现
5Group ID集团号
仅在机构层级文件中出现
6Group Name集团名称
仅在机构层级文件中出现
7Merchant ID商户号
仅在机构层级文件中出现
8Merchant Name商户名称
仅在机构层级文件中出现
9Store ID门店号
仅在机构层级文件中出现
10Store Name门店名称
仅在机构层级文件中出现
11Store MCC门店 MCC
仅在机构层级文件中出现
12Terminal ID终端号
仅在机构层级文件中出现
13Merchant Nation商户国家
仅在机构层级文件中出现
14Merchant City商户城市
仅在机构层级文件中出现
15Merchant Txn Time商户交易时间
仅在机构层级文件中出现
16System Txn TimeEvo Payment 系统交易时间
仅在机构层级文件中出现
17Txn Pay TimePSP 交易时间
仅在机构层级文件中出现
18API TypeAPI 类别
仅在机构层级文件中出现
19Txn Type交易类型
仅在机构层级文件中出现
20Payment Brand支付品牌
仅在机构层级文件中出现
21Payment Method Variant付款方式
仅在机构层级文件中出现
22Merchant Txn ID商户交易号
仅在机构层级文件中出现
23Merchant Order Reference商户订单参考信息
仅在机构层级文件中出现
24System Txn IDEvo Payment 交易号
仅在机构层级文件中出现
25PSP Txn IDPSP 交易号
仅在机构层级文件中出现
26Original Merchant Txn ID原交易商户交易号
仅在机构层级文件中出现
27Original System Txn ID原 Evo Payment 交易号
仅在机构层级文件中出现
28Original PSP Txn ID原交易 PSP 交易号
仅在机构层级文件中出现
29Card Number卡号(前6******后4)
仅在机构层级文件中出现
30Funding Type卡借贷记标识
仅在机构层级文件中出现
31Product ID卡产品标识
仅在机构层级文件中出现
32Product Type ID卡类别标识
仅在机构层级文件中出现
33Issuer Country发卡国家
仅在机构层级文件中出现
34Merchant Local Amt商户本地金额
仅在机构层级文件中出现
35Local Tips Amt小费本地金额
仅在机构层级文件中出现
36Local Surcharge Fee Amt额外服务费本地金额
仅在机构层级文件中出现
37Local Capture Amt商户确认本地金额
仅在机构层级文件中出现
38Merchant Local Curr商户本地币种
仅在机构层级文件中出现
39Rate of Local to TxnMCP/DCC 汇率
仅在机构层级文件中出现
40Merchant Txn Amt商户交易金额
仅在机构层级文件中出现
41Tips Amount小费交易金额
仅在机构层级文件中出现
42Surcharge Fee Amt额外服务费用金额
仅在机构层级文件中出现
43Merchant Capture Amt商户确认金额
仅在机构层级文件中出现
44Merchant Txn Curr商户交易币种
仅在机构层级文件中出现
45User Billing Amt用户扣账金额
仅在机构层级文件中出现
46User Billing Curr用户扣账币种
仅在机构层级文件中出现
47ECI认证标识
仅在机构层级文件中出现
48Txn Initiation Mode交易发起方式
仅在机构层级文件中出现
49LinkPay Order IDLinkPay 订单号
仅在机构层级文件中出现
50Txn StatusEvo Payment 系统交易状态
仅在机构层级文件中出现
51System Result CodeEvo Payment 返回应答码
仅在机构层级文件中出现
52PSP Result CodePSP 渠道应答码
仅在机构层级文件中出现
53PSP Authorization CodePSP 渠道授权码
仅在机构层级文件中出现
54Crossborder Flag跨区标识
仅在机构层级文件中出现
55PSP ARN双信息请款清算号
仅在机构层级文件中出现
56PSP Settlement DatePSP 清算日期
仅在机构层级文件中出现
57PSP Txn AmtPSP 交易金额
仅在机构层级文件中出现
58PSP Txn CurrPSP 交易币种
仅在机构层级文件中出现
59Direct FX RatePSP 交易汇率
仅在机构层级文件中出现
60PSP Sttl AmtPSP 清算金额
仅在机构层级文件中出现
61PSP Discount AmtPSP 优惠金额
仅在机构层级文件中出现
62Acquirer Discount AmtPSP 商户优惠金额
仅在机构层级文件中出现
63PSP Sttl CurrPSP 清算币种
仅在机构层级文件中出现
64Rate for PSP TXN to SttlPSP 清算汇率
仅在机构层级文件中出现
65PSP Interchange FeePSP IC 手续费
仅在机构层级文件中出现
66PSP VAT AmountPSP 增值税费
仅在机构层级文件中出现
67PSP WHT AmountPSP 预扣税费
仅在机构层级文件中出现
68PSP Net Sttl AmtPSP 清算净金额
仅在机构层级文件中出现
69PSP Batch清算批次号
仅在机构层级文件中出现

Samples#

Acquirer IDAcquirer NamePSP 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 FlagPSP ARNPSP Settlement DatePSP Txn AmtPSP Txn CurrDirect FX RatePSP Sttl AmtPSP Discount AmtAcquirer Discount AmtPSP Sttl CurrRate for PSP TXN to SttlPSP Interchange FeePSP VAT AmountPSP WHT AmountPSP Net Sttl AmtPSP Batch
58690282Acquirer1706728PSP3M748857Merchant30S09064179106867Store33581524231686HKGRedactedCity-9C6867C77D8F2028-07-27T17:12:01+08:002028-07-27T17:12:01+08:002028-07-27T17:12:01+08:00PaymentMastercard9733145214968137160115661984261081289618982586263356022174388847068296785550RFMV5V3UM807543******2857DebitMDSConsumerZAF14.990.0014.99USD14.99USD02Success0000X74549International298356929932640430712132028072814.99USD14.99USD-0.2414.75Qflix6
58690282Acquirer1706728PSP3M748857Merchant30S52881997254208Store34472224231686HKGRedactedCity-9C6867C77D8F2028-07-27T19:15:05+08:002028-07-27T19:15:05+08:00RefundMastercard4344400242678259803829681449834911435337652572300727474713273347928872976040IGSY030IH6157241367746588266720098FQFM6210681188103894396878025131678925479684401******6015CreditMCWConsumerHKG-386.340.00-386.34HKD-386.34HKD07Success0000J30228Domestic4037708243867776335312720280728-386.34HKD-386.34HKD3.28-383.06Qflix6
58690282Acquirer1706728PSP3M748857Merchant30S22685876812360Store36549924231686HKGRedactedCity-9C6867C77D8F2028-07-27T15:42:41+08:002028-07-27T15:42:41+08:002028-07-27T15:42:41+08:00PaymentMastercard9781810679832729498522442713278815785666972365605830337928792656828652192265VQE9G8Q08054002******7165CreditMCWConsumerHKG0.100.000.10HKD0.10HKD05Success0000043783Domestic64551615593282564278670202807280.10HKD0.10HKD0.000.10Qflix6
58690282Acquirer1648654PSP11M748857Merchant30S30486452156990Store35539924231686HKGRedactedCity-9C6867C77D8F2028-07-27T17:01:40+08:002028-07-27T17:01:40+08:00RefundVisa7955917717634153668530950733451988036628633813058344221168389287241478400694739637211519411213916048929800756642IWMU9477921149575454576651763358436253525224653******1643DebitFConsumerUZB-72.130.00-72.13HKD-72.13HKDSuccess0085822904International9395757409044947784918820280728-72.13HKD-72.130000HKD0.721300-71.408700
上一页
File-03 Miscellaneous_Detail 清算手工交易流水明细文件
下一页
File-05 PSP_Miscellaneous_Detail 渠道清算异常及特殊交易流水明细文件
Built with