文件说明 - 付临门开放平台

机构对账文件获取与使用

1.1. 文件存储位置

1.1.1. SFTP服务器配置

配置项	值
主机地址	申请后获取
端口	申请后获取
协议	SFTP over SSH
根目录	`/upload/`
目录权限	每个机构仅能访问自己的文件夹

1.1.2. 文件结构规范

目录结构：

[upload]/                              # 机构根文件夹

路径示例：

/upload/128079_20251126.zip            # 压缩对账单文件路径

解压后：

/upload/20251126/ZD_128079_20251126_001.csv
/upload/20251126/YX_128079_20251126_001.csv

1.2. 文件获取方式

1.2.1. 申请获取SFTP账号信息

申请机构方根据公司提供的《机构API对接流程》向运营部门申请开通机构账号信息。

1.2.2. 自动获取

机构系统可通过SFTP客户端定时拉取

建议获取时间：每日02:00后

保留最近90天的历史文件

文件内容规范

2.1. 标准交易对账单（ZD文件）

2.1.1. 文件头定义

CSV：

交易时间,商户号,商户名称,商户订单号,平台订单号,交易类型,支付方式,卡类型,订单金额(元),商户手续费(元),增值手续费,营销金额(元),结算金额(元),参考号,支付源订单号,原平台订单号,机构号,银联商户号,结算周期

2.1.2. 字段说明

字段序号	字段名称	类型	长度	必填	说明
1	交易时间	字符串	19	是	格式：`YYYY-MM-DD HH:MM:SS`
2	商户号	字符串	15	是	付临门商户编号
3	商户名称	字符串	64	是	商户注册名称
4	商户订单号	字符串	32	是	商户侧订单号
5	平台订单号	字符串	32	是	付临门平台订单号
6	交易类型	字符串	10	是	消费、退款等
7	支付方式	字符串	20	是	微信JSPAY、支付宝等
8	卡类型	字符串	8	是	见枚举
9	订单金额(元)	数值	-	是	交易原始金额，保留2位小数
10	增值手续费(元)	数值	-	是	保留2位小数
11	商户手续费(元)	数值	-	是	商户承担手续费，保留2位小数
12	营销金额(元)	数值	-	是	营销活动金额，保留2位小数
13	结算金额(元)	数值	-	是	实际结算金额，保留2位小数
14	参考号	字符串	32	否	支付通道参考号
15	支付源订单号	字符串	32	否	支付通道订单号
16	原平台订单号	字符串	32	否	退款时对应的原交易订单号
17	机构号	字符串	6	是	6位机构编号
18	银联商户号	字符串	15	是	15位银联商户编号
19	结算周期	字符串	10	是	见枚举

2.1.3. 数据规则

交易状态：仅包含成功的交易记录

结算金额计算：

消费交易：结算金额 = 订单金额 − 商户手续费 + 营销金额

退款交易：结算金额 = −退款金额（负值表示支出）

金额精度：所有金额字段保留两位小数

时间格式：北京时间，24小时制

2.1.4. 示例数据

CSV：

交易时间,商户号,商户名称,商户订单号,平台订单号,交易类型,支付方式,订单金额(元),商户手续费(元),营销金额(元),结算金额(元),参考号,支付源订单号,原平台订单号,机构号,银联商户号
2025-11-26 10:35:41,66629047011G10I,温江雨泽百货店,202511261035408343859181,202511261035415979938011,消费,微信-被扫,0.61,0.00,0.00,0.61,,4200002920202510244509021942,,128183,850290470110000
2025-11-26 10:21:02,66629047011G10I,温江雨泽百货店,202511261021024715960181,202511261021026625768291,退款,支付宝退货,0.01,0.00,0.00,-0.01,,2025112522001471971433640643,202511251720073017259341,128183,850290470110000
2025-11-26 10:40:19,66629047011G10I,温江雨泽百货店,202511261040187907824181,202511261040194359448431,消费,微信JSPAY,0.61,0.00,0.00,0.61,,202511261040473618138918,,128183,850290470110000

2.2. 机构营销对账单（YX文件）

2.2.1. 文件头定义

CSV：

交易时间,商户号,商户名称,商户订单号,平台订单号,营销类型,营销金额(元),机构号,银联商户号

2.2.2. 字段说明

字段序号	字段名称	类型	长度	必填	说明
1	交易时间	字符串	19	是	格式：`YYYY-MM-DD HH:MM:SS`
2	商户号	字符串	15	是	付临门商户编号
3	商户名称	字符串	64	是	商户注册名称
4	商户订单号	字符串	32	是	商户侧订单号
5	平台订单号	字符串	32	是	付临门平台订单号
6	营销类型	字符串	20	是	手续费补贴、营销补贴等
7	营销金额(元)	数值	-	是	营销活动金额，保留2位小数
8	机构号	字符串	6	是	6位机构编号
9	银联商户号	字符串	15	是	15位银联商户编号

2.2.3. 数据规则

营销金额：正数表示机构收入，负数表示机构支出

关联交易：每笔营销记录必须对应一笔成功的交易

时间同步：营销交易时间与原始交易时间一致

2.2.4. 示例数据

CSV：

交易时间,商户号,商户名称,商户订单号,平台订单号,营销类型,营销金额(元),机构号,银联商户号
2025-11-26 18:19:26,66629075812HX9P,ces商户测试yj,202511121200187976015705,879991615606,手续费补贴,2.00,128079,85029075812000F

附录

3.1. 交易类型枚举值

交易类型	编码	说明
消费	B0010	普通消费交易（正向交易）
退款	B0073	交易退款（反向交易）

3.2. 支付方式枚举值

支付方式	编码	方向（0:入 1:出）
POS消费	POS_CONSUME	0
POS消费冲正	POS_CONSUME_ROLLBACK	1
POS消费撤销	CONSUME_CANCEL_POS	1
支付宝-被扫	QR_ALIPAY_BARPAY	0
微信-被扫	QR_WECHAT_BARPAY	0
银联二维码-被扫	QR_UNIONPAY_BARPAY	0
支付宝-主扫	ALIPAY_NATIVEPAY	0
微信-主扫	WECHAT_NATIVEPAY	0
押金	DESPOSIT_CASH	0
微信JSPAY	WECHAT_JSPAY	0
支付宝JSPAY	ALIPAY_JSPAY	0
云闪付JSPAY	UNIONPAY_JSPAY	0
微信撤销	CONSUME_CANCEL_WECHAT	1
支付宝撤销	CONSUME_CANCEL_ALIPAY	1
银联二维码撤销	CONSUME_CANCEL_UNIONPAY	1
银联二维码-主扫	QR_UNIONPAY_NATIVEPAY	0
POS预授权	POS_AUTH	0
POS预授权撤销	POS_AUTH_CANCEL	1
POS预授权完成	POS_AUTH_COMPLETE	0
POS预授权完成撤销	POS_AUTH_COMPLETE_VOID	1
POS预授权冲正	POS_AUTH_ROLLBACK	1
POS预授权完成冲正	POS_AUTH_COMPLETE_ROLLBACK	1
微信-扫码-担保	QR_WCHAT_AUTH	0
微信-扫码-担保撤销	QR_WCHAT_AUTH_CANCEL	1
微信-扫码-担保完成	QR_WCHAT_AUTH_COMPLETE	0
支付宝-扫码-担保	QR_ALIPAY_AUTH	0
支付宝-扫码-担保撤销	QR_ALIPAY_AUTH_CANCEL	1
支付宝-扫码-担保完成	QR_ALIPAY_AUTH_COMPLETE	0
POS退货	POS_REFUND	1
微信退货	CONSUME_REFUND_WECHAT	1
支付宝退货	CONSUME_REFUND_ALIPAY	1
银联二维码退货	CONSUME_REFUND_UNIONPAY	1
微信急速退货	CONSUME_ACC_REFUND_WECHAT	1
支付宝急速退货	CONSUME_ACC_REFUND_ALIPAY	1
银联二维码急速退货	CONSUME_ACC_REFUND_UNIONPAY	1
POS消费-EDC	POS_CONSUME_EDC	0
POS消费-DCC	POS_CONSUME_DCC	0
POS预授权-EDC	POS_AUTH_EDC	0
POS预授权撤销-EDC	POS_AUTH_EDC_CANCEL	1
POS预授权完成-EDC	POS_AUTH_EDC_COMPLETE	0
POS预授权完成撤销-EDC	POS_AUTH_EDC_COMPLETE_VOID	1
POS预授权-DCC	POS_AUTH_DCC	0
POS预授权撤销-DCC	POS_AUTH_DCC_CANCEL	1
POS预授权完成-DCC	POS_AUTH_DCC_COMPLETE	0
POS预授权完成撤销-DCC	POS_AUTH_DCC_COMPLETE_VOID	1
数字人民币-被扫	QR_ECNY_BARPAY	0

3.3. 营销类型枚举值

营销类型	编码	说明
手续费补贴	COMMISSION	手续费补贴活动
营销补贴	MARKETING	营销补贴

3.4. 卡类型枚举值

卡类型	编码	说明
信用卡	C	-
借记卡	D	-
未知卡	U	非卡类交易

3.5. 结算周期枚举值

结算周期	编码	说明
当天结算	D0	交易发生当日完成结算
自然日次日结算	D1	交易发生后的下一个自然日完成结算
工作日次日结算	T1	交易发生后的下一个工作日完成结算
营销结算周期	M	营销活动相关的结算周期（按营销活动约定的规则执行）
D1定时结算	DD	基于D1结算周期的定时结算
T1定时结算	DT	基于T1结算周期的定时结算
快速结算代付	KS	快速结算模式，通过代付方式完成
D1快速结算	KD	基于D1结算周期的快速结算
T1快速结算	KT	基于T1结算周期的快速结算