Skip to main content

交易流水

无论您是要逐笔核对资金、还原一笔消费的完整时序,还是满足监管对资金流向可追溯的要求,交易流水(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,不会写入每日交易文件;授权侧 transactionTypeR / C / Q / P 又是另一维度,请勿混用。

多笔清算标识(multiClearInd)

同一笔授权可能被分多次清算(如商户分批发货、酒店退房分项结算)。multiClearInd 标识当前流水在多笔清算中的位置:
多笔清算时,请以收齐 F 标识的那一笔为「该授权清算完成」的判定依据。在收到 F 之前,同一 authIds 下可能还会陆续到达 P 流水。

如何获取交易流水

合作伙伴自管方案中,交易流水不提供实时单笔查询接口,统一通过每日全量对账文件交付。DCS 每日为每个接入机构(Enterprise)生成一份当日全量的交易流水文件。 接口(领取下载链接)
响应:返回字符串形式的文件下载链接(S3 临时链接,有效期较短,请领取后尽快下载)。
谁做什么
  • DCS:每日生成全量交易流水文件,按需签发临时下载链接。
  • 接入机构:调用本接口领取链接 → 下载文件 → 存储核对账户余额变动与实际业务是否一致。
关于文件与链接:系统默认 T+1 生成前一日的授权、交易两类文件,任务状态为 DONE 后可下载;具体每日运行时刻由任务平台配置。下载链接固定有效 120 秒,过期后可再次调用接口领取新的 120 秒链接,底层文件不会因链接过期而删除。
下载链接的统一获取方式与每日对账机制,另见 交易报告

交易流水文件字段

每行一条流水,字段以 > 分隔,顺序如下: 示例样本
上方两行恰好演示了取现场景:第一行 CASH 为取现本金,第二行 CASH_FEES 为取现手续费,两条流水共享同一卡号、同一商户。两行末尾的 > 后为空,因为非退款交易不带 originalTransactionId
为便于存储映射,下面把上方第一行 > 分隔样本按相同字段名展开为一条等价的结构化记录(字段名与上方字段表一一对应):
交易流水实际以上述 > 分隔的文本文件形式交付,本 JSON 仅为字段对照示意,不代表存在某个返回 JSON 的接口。multiClearInd 在该样本中原值为 null(非取现场景下取 O/P/F)。

下一步