交易流水
无论您是要逐笔核对资金、还原一笔消费的完整时序,还是满足监管对资金流向可追溯的要求,交易流水(Transaction)都是判断资金结果的权威凭证。DCS 作为持牌发卡机构,将每一笔实际发生的资金变动记录为不可篡改的流水,并通过每日全量对账文件交付给接入机构。 交易流水只记录资金的实际扣除与增加,不包含授权阶段的冻结、解冻等中间状态——它是资金最终流转结果的权威记录,与授权(Authorisation)、待清算(Outstanding)共同构成完整的资金生命周期。它在资金生命周期中的位置
授权决定「冻结多少」,清算决定「最终扣多少」,交易流水就是清算落地后的那条记录。三者通过 ID 串联:- 一笔交易流水通过
outsId关联到待清算记录,通过authIds关联到一笔或多笔授权(多笔授权时用英文逗号分隔,如1111,2222)。 - 多笔授权、增量授权、部分清算等组合场景下,授权与流水的对应关系并非一一对应。完整的组合场景(普通清算、增量、撤销、超额/少额清算、强制清算、提现等 13 种)请参阅 授权与清算全场景。
交易方向(direction)
direction 字段区分两类核心场景:
交易分类(category)
category 字段对每笔流水做业务分类,是接入机构做业务分析与成本核算的基础维度。
取现本金与手续费如何区分? 取现场景下,category=CASH是本金,category=CASH_FEES是手续费,两者分别落两条流水。提现手续费走独立的强制记账流程,详见 授权与清算全场景 · 场景十三。 关于取现/提现的分类取值:每日交易文件的category固定使用全称(如RETAIL/CASH/CASH_FEES/PAYMENT)。C/CF/R等是内部枚举 code,不会写入每日交易文件;授权侧transactionType的R/C/Q/P又是另一维度,请勿混用。
多笔清算标识(multiClearInd)
同一笔授权可能被分多次清算(如商户分批发货、酒店退房分项结算)。multiClearInd 标识当前流水在多笔清算中的位置:
多笔清算时,请以收齐F标识的那一笔为「该授权清算完成」的判定依据。在收到F之前,同一authIds下可能还会陆续到达P流水。
如何获取交易流水
合作伙伴自管方案中,交易流水不提供实时单笔查询接口,统一通过每日全量对账文件交付。DCS 每日为每个接入机构(Enterprise)生成一份当日全量的交易流水文件。 接口(领取下载链接)
响应:返回字符串形式的文件下载链接(S3 临时链接,有效期较短,请领取后尽快下载)。
谁做什么下载链接的统一获取方式与每日对账机制,另见 交易报告。关于文件与链接:系统默认 T+1 生成前一日的授权、交易两类文件,任务状态为
- DCS:每日生成全量交易流水文件,按需签发临时下载链接。
- 接入机构:调用本接口领取链接 → 下载文件 → 存储核对账户余额变动与实际业务是否一致。
DONE后可下载;具体每日运行时刻由任务平台配置。下载链接固定有效 120 秒,过期后可再次调用接口领取新的 120 秒链接,底层文件不会因链接过期而删除。
交易流水文件字段
每行一条流水,字段以> 分隔,顺序如下:
示例样本
上方两行恰好演示了取现场景:第一行为便于存储映射,下面把上方第一行CASH为取现本金,第二行CASH_FEES为取现手续费,两条流水共享同一卡号、同一商户。两行末尾的>后为空,因为非退款交易不带originalTransactionId。
> 分隔样本按相同字段名展开为一条等价的结构化记录(字段名与上方字段表一一对应):

